Skip to content

Partner recordings ​

GET /partner/recordings?limit=50&cursor=<opaque> ​

Returns recordings created by the authenticated Partner, newest first. limit accepts 1 to 100. delayed_processing is described under GET /video/{video_id}/status.

Sample response

json
{
  "data": [
    {
      "video_id": "B92BFC8A-2454-4632-9580-F96E99FB7C85",
      "device_id": "4580f207-b672-4df0-83eb-110cc408466b",
      "venue_id": "ac8e2b99-9dce-44fe-a317-4bfdfee12187",
      "sport": "padel",
      "game_type": "doubles",
      "recording_type": "match",
      "status": "OK",
      "delayed_processing": "not_expected",
      "title": "Example Court",
      "scheduled_at": "2026-08-01T17:00:00Z",
      "start_time": "2026-08-01T17:02:00Z",
      "end_time": "2026-08-01T18:30:00Z",
      "created_at": "2026-08-01T16:00:00Z",
      "app_link": "https://app.clutchapp.io/match/B92BFC8A-2454-4632-9580-F96E99FB7C85"
    }
  ],
  "next_cursor": null
}

Use next_cursor to request the next page.

GET /partner/recordings/{video_id}/players ​

Returns the recording's player slots, each with its team and the linked Partner player who holds it. Use it to reconcile player.identification_changed events.

Sample response

json
{
  "data": {
    "video_id": "B92BFC8A-2454-4632-9580-F96E99FB7C85",
    "players": [
      {
        "ai_player_id": "player-14",
        "pair": "pair-1",
        "partner_player_id": "partner_player_813742"
      },
      {
        "ai_player_id": "player-158",
        "pair": "pair-1",
        "partner_player_id": null
      },
      {
        "ai_player_id": "player-25",
        "pair": "pair-2",
        "partner_player_id": null
      },
      {
        "ai_player_id": "player-27",
        "pair": "pair-2",
        "partner_player_id": "partner_player_205118"
      }
    ]
  }
}

ai_player_id is the player's slot in this recording and pair is the team, pair-1 or pair-2. A slot that no linked player holds has partner_player_id: null. A linked player who joined the recording but has not tagged themselves yet appears with ai_player_id and pair null. A recording that is still processing has no slots yet. The recording must belong to the Partner; otherwise HTTP 403 with video_not_owned.

Clutch Partner API · v1