GoSportsAPIDocs
Sign InGet API Key
Motorsport / Races

Get Races

Retrieve the race calendar for a series and season — round, circuit, start time and status for every event.

GET/v1/motorsport/races

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
series_idintegerOptionalFilter by series ID.
seasonintegerOptionalFilter by season year.
datedateOptionalFilter by race date (YYYY-MM-DD, UTC).
statusstringOptionalNS, LIVE, HT, FT, PST or CANC.
pageintegerOptionalPage number. Default 1, 50 per page.

Response

  • dataarray<Race>
    Races matching your filters.
  • idinteger
    Unique race ID.
  • seriesobject
    id and name.
  • seasoninteger
    Season year.
  • roundinteger
    Round of the championship.
  • namestring
    Event name.
  • circuitobject
    Circuit name, city and country.
  • datestring · ISO 8601
    Race start in UTC.
  • statusobject
    short and long.
  • metaobject
    page, per_page and total.

Status codes

  • 200Races returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached