/horse-racing/races/{id}/briefingRace 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.
Parameters
idinteger · pathrequiredRace ID
langstring · queryLanguage of sentences: de, es, it, fr
formatstring · querymd for Markdown
Response
JSON with success, the result in data, and where the endpoint pages its results meta.
dataobjectafter_racebooleanas_ofstringdistancestringfactsarray of objectbased_onarray of integerhistory_fromstringimportanceintegerincompletebooleana match without a result cuts it: no sentence
opponentobjectplayer_idintegersincestringteamobjectteam_idintegerFlat 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).
textstringtypestringvalueintegervaluesobjectfavouritesarray of objectjoint favourites share the price
decimalnumberhorsestringhorse_idintegersourcestringsp, best_price or morning_line
field_sizeintegergoingstringhistory_fromstringHistoryFrom: form and strike rates only count our results since this day.
non_runnersintegerraceobjectdistancestringeach_wayobjectEachWay is the most common each-way terms across bookmakers; individual bookmakers may offer different terms (see each quote's each_way).
idintegermeetingobjectpursestringrace_classstringrace_datestringRaceDate and StartTime are UTC.
race_namestringresults_finalbooleanResultsFinal is true once every declared runner is accounted for as a finisher, a non-finisher or a non-runner.
runnersarray of objectrunners_countintegersportstringstart_timestringstart_utcstringStartUTC is the scheduled off-time in ISO 8601 UTC.
statusstringStatus: 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.
surfacestringupdated_atstringUpdatedAt is when the race or any of its runners last changed (UTC, RFC 3339).
wagersobjectrace_classstringresultobjectfavourite_wonbooleanFavouriteWon is null without a favourite.
winnersarray of objectrunnersarray of objectformstringour results, oldest left, latest right: 1-9, 0 = 10th or worse, a letter = did not finish
horsestringhorse_idintegerjockeyobjectlast_runobjectnon_runnerbooleannumberstringruns_in_our_dataintegertrainerobjectsportstringerrorobjectcodestringmessagestringmetaobjectattributionstringAttribution a data source's licence asks for (Cricsheet's history).
limitintegeroffsetintegertotalintegersuccessboolean
Errors
| Status | Code | When |
|---|---|---|
| 402 | x402 offers | No key and no valid payment: the body lists what to pay. Only a 200 answer is charged. |
| 404 | NOT_FOUND | No 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