Skip to content
datasportsAPI

CatalogSports

Documentation

/

Type to filter the docs by title or path.

CatalogEndpoint 1 of 116

Sports

GET

/v2/sports

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
None
Returns
An object (see Response)

Lists all supported sports, each with the number of matches live right now.

Matches the source has left open — 45 min without any change, with a kick-off further back than a match in that sport could run — do not count towards it. kind tells you which endpoint family serves the sport: fixtures, for sports served by the Fixtures, Teams and Leagues endpoints; races, for motorsport and cycling, which the Race sports endpoints cover (their fixture lists stay empty).

01Request

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/sports"

02Response

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

data
{ slug: string; name: string; kind: "fixtures" | "races"; live: number }[]
meta
count
Example response
{ "data": [ { "slug": "football", "name": "Football", "kind": "fixtures", "live": 42 }, { "slug": "ice-hockey", "name": "Ice hockey", "kind": "fixtures", "live": 9 }, …,
    { "slug": "motorsport", "name": "Motorsport", "kind": "races", "live": 0 } ],
  "meta": { "count": 24 } }

03Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code