Dealt exposes simple URL endpoints that return JSON, making it easy to build Apple Shortcuts or integrate with other automation tools.

In Apple Shortcuts, use the "Get Contents of URL" action with these endpoints.

Check the current scores and status of any game.

Parameters:

• game — The game session ID (required)

Returns: Game type, status, players with scores, hand count, winner (if completed)

{
  "id": 42,
  "game_type": "Rummy",
  "status": "in_progress",
  "players": [
    { "id": 1, "name": "Sam", "total_score": 150, "final_rank": null },
    { "id": 2, "name": "Alex", "total_score": 120, "final_rank": null }
  ],
  "hands": 5
}

Add a score to an active game (creates a new hand).

Parameters:

• game — The game session ID (required)
• player — The player ID (required)
• score — The score to add (required)

Returns: { "success": true, "hand_number": 6, "score": 25 }

Start a new game with specified players.

Parameters:

• game_type — The game type ID (required)
• players — Comma-separated player IDs (required, minimum 2)

Returns: { "success": true, "game_id": 43, "url": "/games/43/play" }

• Find your player and game type IDs on the Players and Game Types pages
• All endpoints use GET requests for maximum compatibility with Shortcuts
• Responses are always JSON — use "Get Dictionary Value" in Shortcuts to extract fields
• These endpoints work from any HTTP client — curl, Shortcuts, Zapier, etc.