Skip to content
datasportsAPI

Race sportsRaces

Documentation

/

Type to filter the docs by title or path.

Race sportsEndpoint 91 of 116

Races

GET

/v2/races

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

Returns every race that has a session beginning on a given UTC day, with all of each race’s sessions included.

Worth knowing

A day lists no more than 40 races. A race weekend shows up on each day on which one of its sessions begins. Our data source sometimes records a weekend twice, under two identically named series (NASCAR Cup Series); we drop the copy whose series has no seasons from the day’s list, although its id still resolves on /v2/races/{id}.

01Parameters

  • sportqueryRequired

    motorsport \| cycling

  • datequeryRequired

    UTC date in YYYY-MM-DD format

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/races?sport=…&date=…"

03Response

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

data
Race[]
meta
date, sport, count, complete (false if some races were temporarily unavailable — try again shortly)
ObjectsRace
Example call and response
$ curl -H "Authorization: Bearer dsa_live_…" "https://api.datasportsapi.com/v2/races?sport=motorsport&date=2026-10-11"

{ "data": [ { "id": 812345, "name": "Singapore GP", "sport": "motorsport", "series": { "id": 812300, "name": "Formula 1", … },
    "status": "finished", "startDate": "2026-10-09", "endDate": "2026-10-11", "sessions": [ … ], … }, … ],
  "meta": { "date": "2026-10-11", "sport": "motorsport", "count": 3, "complete": true } }

04Errors

  • 400bad_request

    the date is missing or not a valid day, or the sport is not one of the race sports

  • 403history_not_in_plan

    your plan’s history does not reach back to that date

  • 503upstream_unavailable

    every race of the day failed to load

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code