A race's dividends
Live, Archive and Complete
Tote returns and prizes.
Examplea real answer from 2026-10-29, trimmed to a few rows
{
"data": {
"race_id": "rc_0aa1c4st",
"course": "Abu Dhabi",
"date": "2026-10-29",
"dividends": {
"currency": "AED",
"straight_forecast": 85.59
},
"prizes": [
{
"position": 1,
"prize": 39601
},
{
"position": 2,
"prize": 13202
},
{
"position": 3,
"prize": 7259
}
]
},
"meta": {
"request_id": "a0fec08b23811581",
"plan": "complete",
"window": "January 2017 to the next 3 days",
"data_as_of": "2026-10-30T12:04:04+00:00"
}
}Parameters
| Name | In | Type | Required | What it does |
|---|---|---|---|---|
race_id | path | id | yes | Our id for the race, as other answers give it (rc_ and eight characters). |
Returns
One record in data. Every answer carries meta: request_id, plan, window and data_as_of.
| Field | Type | Holds |
|---|---|---|
race_id | string | Our id for the race. |
course | string | The course name. |
date | string | The UK racing day, YYYY-MM-DD. |
dividends | object | Tote returns, in pounds. Null on the free key. |
dividends.currency | string | |
dividends.straight_forecast | number | |
prizes | array | Prize money by place, in pounds. |
prizes[].position | integer | Where it finished; null for a non-finisher. |
prizes[].prize | integer | The prize to the winner, in pounds. |
Errors
| Code | Status | When |
|---|---|---|
unauthorized | 401 | No key was sent, or the key is not one of ours. |
upgrade_required | 403 | Your plan does not reach this endpoint. The answer names the plans that do. |
outside_plan_window | 403 | The day asked for is outside what your plan reads. The answer gives your window and the day you asked for. |
bad_request | 400 | A value is the wrong shape: a date that is not YYYY-MM-DD, a cursor that is not ours, or a key sent in the address. |
unknown_parameter | 422 | A parameter this endpoint does not take. The answer lists the ones it does. |
not_found | 404 | No record has that id, or it is not British or Northern Irish racing. |
rate_limited | 429 | Too many calls this minute for your plan. |
quota_exceeded | 429 | Your plan's calls for the month are used. The answer says when they reset. |