Listing a day's results
/v1/resultsAll live plansPaginated races that have published finishers in the selected feed.
The list only contains races with a non-empty finishers array. On a race day it normally grows as results arrive. An empty list means this request returned no published finishers: there may be no meetings, results may not yet be available, or historical coverage may be incomplete. It is not proof of abandonment. Results use raceId rather than id; use that field when joining them to racecards.
Use the same day selectors as racecards: nothing for today, date=YYYY-MM-DD for an earlier day. UK archive dates have been sampled successfully back to 2016, which is not a promise that every intervening day is complete. Pagination is identical too: request until page * limit >= meta.total.
const url = new URL("/v1/results", "https://racingapi.net");
url.searchParams.set("region", "uk");
if (process.env.RACE_DATE) url.searchParams.set("date", process.env.RACE_DATE);
url.searchParams.set("limit", "100");
const res = await fetch(url, { headers: { "X-API-Key": process.env.RACINGAPI_KEY } });
const body = await res.json();
if (!res.ok) throw new Error(body.code + " " + body.requestId);
for (const result of body.data) {
const winner = result.finishers.find(f => f.position === "1");
console.log(result.raceId, result.course.name, result.name, winner ? winner.name : "no winner listed");
}One race result
/v1/results/{raceId}All live plansFinishers and wagers for one race in the selected feed.
The examples above fetch one page for today unless you set RACE_DATE to YYYY-MM-DD. For yesterday, calculate yesterday's calendar date in Europe/London, then supply it. To retrieve a complete day, follow meta.total using the pagination loop from Racecards. Replace {raceId} with a discovered ID and carry the same date. A 404 can mean a result is not yet published, but also a wrong ID, wrong date or unavailable archive. Only treat it as pending when you have verified that race in the matching racecards, and use bounded polling.
curl --fail-with-body \
"https://racingapi.net/v1/results/$RACE_ID?region=uk&date=$RACE_DATE" \
-H "X-API-Key: $RACINGAPI_KEY"Rendering finishers and dividends
| Field | How to display it |
|---|---|
| position | Finishing position or a non-numeric outcome code. Do not cast to a number blindly. |
| name, horseId | Horse name; horseId joins back to racecard runners. |
| startingPrice | The source SP string, without conversion. |
| distance | Beaten distance or margin text as supplied. |
| jockey, trainer | Display names. Trainer can be empty when not supplied; it is never guessed. |
| silkUrl | Authenticated relative image path; fetch through your server. |
wagers[] holds source dividend and pool records with type, numbers, payoff and pool. Display them as published. The currency and stake basis of payoff are not inferred, so label the table 'Dividends as supplied' and avoid computing returns from them.
- 1Racecard race.id. Store the ID and the day you discovered it on.
- 2Poll results list. After the off, check the day's list on a slow interval.
- 3Match on raceId. When the race appears, read finishers and wagers.
- 4Stop polling that race. Published results change rarely; cache them for minutes, not seconds.
Reference material
Exact schemas: API reference. First call: Quickstart. Copy-ready helpers: Code examples. Plans: Pricing.