Skip to content
Get a key
API reference / Horse racing
GET/horse-racing/races

List horse racing races

Returns a paginated list of horse racing races with optional filtering. race_date and start_time are UTC.

Horse racing plan featurePay per call without a key: $0.002 in USDC

Parameters

  • meeting_idinteger · query

    Filter by meeting (racecourse) ID

  • race_idstring · query

    Comma-separated race IDs (max 100)

  • datestring · query

    Filter by UTC race date (YYYY-MM-DD)

  • statusstring · query

    Filter by status

    One of: NS, live, result_pending, FT
  • regionstring · query

    Filter by region (usa, uk, australia, hk, singapore, dubai, sa, france)

  • futurestring · query

    Filter to races dated today (UTC) or later, including today's finished races (true)

  • updated_sincestring · query

    Only races that changed (race or any runner) after this RFC 3339 timestamp

  • limitinteger · query

    Maximum results (1-100)

    Default: 50
  • offsetinteger · query

    Results to skip

    Default: 0

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataarray of object
  • distancestring
  • each_wayobject

    EachWay is the most common each-way terms across bookmakers; individual bookmakers may offer different terms (see each quote's each_way).

  • fractionstring
  • placesinteger
  • idinteger
  • meetingobject
  • datestring

    Date is the local card date (YYYY-MM-DD). It can precede the UTC race_date when a card runs past midnight UTC.

  • goingstring
  • idinteger

    ID is the the data provider racecourse id. It is reused every day the course races, so a meeting is identified by (id, date).

  • namestring
  • regionstring
  • pursestring
  • race_classstring
  • race_datestring

    RaceDate and StartTime are UTC.

  • race_namestring
  • results_finalboolean

    ResultsFinal is true once every declared runner is accounted for as a finisher, a non-finisher or a non-runner.

  • runnersarray of object
  • agestring
  • distancestring
  • genderstring
  • horse_namestring
  • idinteger

    ID is the the data provider horse id.

  • jockeyobject
  • morning_lineobject
  • numberstring

    Number is the saddle-cloth number; outcome codes never appear here.

  • oddsobject
  • race_idinteger
  • ratingstring
  • recent_formobject
  • resultobject
  • stallstring
  • statusstring

    Status is "runner", "non_runner" (withdrawn) or "did_not_finish".

  • trainerobject
  • updated_atstring

    UpdatedAt is when anything about this runner last changed (UTC, RFC 3339).

  • weightstring
  • weight_lbsstring
  • runners_countinteger
  • sportstring
  • start_timestring
  • start_utcstring

    StartUTC is the scheduled off-time in ISO 8601 UTC.

  • statusstring

    Status: NS (not started), live (off within the last 30 minutes, no results yet), result_pending (off more than 30 minutes ago, no results yet), FT (results published). the data provider sends no called-off signal, so an abandoned race stays result_pending.

  • surfacestring
  • updated_atstring

    UpdatedAt is when the race or any of its runners last changed (UTC, RFC 3339).

  • wagersobject
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
429RATE_LIMIT_EXCEEDEDToo many requests (QUOTA_EXCEEDED for the daily limit). Wait for Retry-After.
500INTERNAL_ERROROur side. Try again after a few seconds and check the status page.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?