Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Players

Player fixtures

GET

/v2/players/{id}/fixtures

All plans

View as MarkdownTry in Playground →

One page of the player’s most recent fixtures, across every team they appeared for; since 2026-10-24 each page lists the newest first. Page 0 opens with any fixtures not yet started, soonest first (since 2026-10-27; earlier, a player with two matches ahead saw the later one first), then continues with the rest newest first. Every fixture includes playerMatch: the side the player was on, whether they remained on the bench, their rating, their match statistics (minutes in football; box scores in basketball and ice hockey) and their goals, assists and cards.

A known player with no fixtures at the source gets 200 and an empty array. playerMatch.statistics shares its per-player keys with the lineups.

Parameters

id

pathrequired

DataSportsAPI player id, a positive integer

page

query

zero-based page number, a whole number from 0 to 50; the default 0 holds the most recent fixtures

Response

meta
page, count, hasNextPage
errors
400 bad_request — page is not a whole number between 0 and 50

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/players/{id}/fixtures"
Example
{ "data": [ { "id": 201324, "status": { "type": "finished", … }, "home": { … }, "away": { … }, …,
      "playerMatch": { "side": "away", "onBench": false, "rating": 8.1, "statistics": { "minutesPlayed": 90 },
                       "incidents": { "goals": 1, "penaltyGoals": 1 } } }, … ],
  "meta": { "page": 0, "count": 30, "hasNextPage": true } }