Skip to content
datasportsAPI

TeamsTeam fixtures

Documentation

/

Type to filter the docs by title or path.

TeamsEndpoint 32 of 116

Team fixtures

GET

/v2/teams/{id}/fixtures

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 2 optional
Returns
Fixture[]
Try in Playground

Returns one page of a team’s fixtures, either recent or upcoming.

Worth knowing

  • If the team exists but has nothing to list, the response is 200 with an empty array.
  • Since 2026-10-24 every competitor list splits matches the same way.
  • upcoming holds matches not yet started (including ones postponed to a future date), soonest first, and page 0 also includes a next match that the source has filed under recent (tennis players, fighters).
  • recent holds live, finished and called-off matches, with the newest at the top of every page.
  • For a live or just-finished match, status, score and clock are accurate to the second.
  • Once a match kicks off it moves to recent on your next request, and both lists are rebuilt on the first request after any of the team’s matches ends, is rescheduled or is postponed (see Data freshness).

01Parameters

  • idpathRequired

    DataSportsAPI team id, a positive integer

  • typequeryOptional

    recent \| upcoming; upcoming when omitted

  • pagequeryOptional

    zero-based page number, a whole number from 0 to 50 (defaults to 0)

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/fixtures"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
Fixture[]
meta
type, page, count, hasNextPage
ObjectsFixture
Example response
{ "data": [ { "id": 202006, "status": { "type": "finished", … }, … } ],
  "meta": { "type": "recent", "page": 0, "count": 30, "hasNextPage": true } }

04Errors

  • 400bad_request

    type is neither recent nor upcoming, or page is not a whole number between 0 and 50

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code