Linked player history

GET /partner/players/{partner_player_id}/history?limit=50&cursor=<opaque>

Returns the linked player's worldwide Clutch history, including recordings they joined but have not tagged themselves in yet.

Sample response

{
  "data": {
    "partner_player_id": "partner_player_813742",
    "consented_at": "2026-07-15T10:00:00Z",
    "summary": {
      "player_rating": 7.5,
      "rating_confidence": 82,
      "rating_provisional": false,
      "rated_matches": 22,
      "rating_scale": {
        "minimum": 1,
        "maximum": 10,
        "unrated_value": null
      },
      "total_matches": 24,
      "scored_matches": 22,
      "win_loss": {
        "wins": 14,
        "losses": 8
      }
    },
    "matches": [
      {
        "video_id": "B92BFC8A-2454-4632-9580-F96E99FB7C85",
        "recorded_at": "2026-08-01T17:02:00Z",
        "device_id": "4580f207-b672-4df0-83eb-110cc408466b",
        "venue_id": "ac8e2b99-9dce-44fe-a317-4bfdfee12187",
        "sport": "padel",
        "game_type": "doubles",
        "status": "OK",
        "title": "Example Match",
        "ai_player_id": "player-14",
        "result": "win",
        "score": {},
        "metrics": {
          "player_rating": 7.42,
          "fastest_smash": 112.5,
          "first_serve_percentage": 74.2,
          "first_serve_speed": 88.4,
          "aces": 3,
          "winners": 12,
          "unforced_errors": 8,
          "winner_to_unforced_error_ratio": 1.5,
          "net_points_won": 10,
          "average_rally_length": 6.8,
          "double_faults": 2,
          "second_serve_speed": 72.1,
          "average_shot_speed": 61.7,
          "calories": 544.3,
          "distance_ran": 1234.5,
          "steps": 1662,
          "smash_error_rate": 20.0,
          "smash_conversion_rate": 40.0,
          "lob_recovery_rate": 66.67,
          "net_approach_success_rate": 58.33,
          "volley_winners": 5,
          "volley_errors": 2,
          "average_lob_height": 5.4
        },
        "app_link": "https://app.clutchapp.io/match/B92BFC8A-2454-4632-9580-F96E99FB7C85"
      }
    ],
    "next_cursor": null
  }
}

ai_player_id is the slot the player holds in that recording, matching GET /partner/recordings/{video_id}/players, and is null until they tag themselves. Unrated players return player_rating: null. summary.player_rating is the padel doubles Clutch Score. rating_confidence (0 to 100) shows how much recent evidence supports it; it builds with play, fades during breaks, and is not an accuracy probability. rating_provisional is true with fewer than five qualifying matches, and rated_matches counts the qualifying matches. rating_confidence and rating_provisional are null without a score. HTTP 409 with player_not_linked means consent is incomplete.