Skip to content
API reference / Horse racing
GET/horse-racing/races/{id}/briefing

Race briefing

Ready context for one race from our stored results: field size, distance, going, class; the favourite (shortest starting price after the race, else best current price, else morning line); each runner's form figures and last run; jockey and trainer wins, rides and strike rate over the 30 days before race day (a sentence from 5 rides). After the race: winner, starting price, whether the favourite won. Every statement also as a sentence (lang=de, es, it, fr). Facts only; prices are data fields, never sentences. format=md returns Markdown.

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

Parameters

  • idinteger · pathrequired

    Race ID

  • langstring · query

    Language of sentences: de, es, it, fr

  • formatstring · query

    md for Markdown

Response

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

  • dataobject
  • after_raceboolean
  • as_ofstring
  • distancestring
  • factsarray of object
  • based_onarray of integer
  • history_fromstring
  • importanceinteger
  • incompleteboolean

    a match without a result cuts it: no sentence

  • opponentobject
  • player_idinteger
  • sincestring
  • teamobject
  • team_idinteger

    Flat fields for consumers that do not read values: the team's and player's id, the fact's main number, the day a run or "first since" reaches back to, and the start of our data (no claim reaches further).

  • textstring
  • typestring
  • valueinteger
  • valuesobject
  • favouritesarray of object

    joint favourites share the price

  • decimalnumber
  • horsestring
  • horse_idinteger
  • sourcestring

    sp, best_price or morning_line

  • field_sizeinteger
  • goingstring
  • history_fromstring

    HistoryFrom: form and strike rates only count our results since this day.

  • non_runnersinteger
  • raceobject
  • 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).

  • idinteger
  • meetingobject
  • 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
  • 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
  • race_classstring
  • resultobject
  • favourite_wonboolean

    FavouriteWon is null without a favourite.

  • winnersarray of object
  • runnersarray of object
  • formstring

    our results, oldest left, latest right: 1-9, 0 = 10th or worse, a letter = did not finish

  • horsestring
  • horse_idinteger
  • jockeyobject
  • last_runobject
  • non_runnerboolean
  • numberstring
  • runs_in_our_datainteger
  • trainerobject
  • sportstring
  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

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

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
404NOT_FOUNDNo record with that id.

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?