Dividends

GET /v1/races/{race_id}/dividends

Tote returns and prizes, where the jurisdiction published them.

Available on

Free key 24h – 7d

Live today + 3 days

Archive back to 2017

Complete 2017 → upcoming

Complete + Analyst 2017 → upcoming

Send your key in the X-API-Key header, or as ?key= if your tool cannot set one. A date outside your plan's window returns 403 outside_window naming the window, never an empty array.

Parameters

Name	In	Type	Required	Description
race_id	path	string	yes	Opaque race identifier.

Request

curl https://api.apihorseracing.com/v1/races/rc_1P005G7/dividends \
  -H "X-API-Key: $AHR_KEY"

$ch = curl_init('https://api.apihorseracing.com/v1/races/rc_1P005G7/dividends');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ['X-API-Key: ' . getenv('AHR_KEY')],
]);
$data = json_decode(curl_exec($ch), true)['data'];

const res = await fetch(
  'https://api.apihorseracing.com/v1/races/rc_1P005G7/dividends',
  { headers: { 'X-API-Key': process.env.AHR_KEY } }
);
const { meta, data } = await res.json();

import os, requests

r = requests.get(
    "https://api.apihorseracing.com/v1/races/rc_1P005G7/dividends",
    headers={"X-API-Key": os.environ["AHR_KEY"]},
).json()

Response

200 OK application/json harvested 8 days ago

{
    "meta": {
        "request_id": "74c074af92258094",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming"
    },
    "data": {
        "race_id": "rc_1P005G7",
        "course": "Fontwell",
        "date": "2021-02-28",
        "dividends": {
            "currency": "GBP",
            "win": 4.7,
            "place": [
                1.4,
                1.1,
                "… 1 more"
            ],
            "exacta": 6.9,
            "trifecta": 86.9,
            "straight_forecast": 5.4,
            "swingers": [
                1.2,
                11.2,
                "… 1 more"
            ],
            "place_pot": {
                "pot": 5.7,
                "pool": 80542.57,
                "win_stakes": 10142.17
            },
            "quad_pot": {
                "pot": 1.8,
                "pool": 6901.81,
                "win_stakes": 2706.56
            }
        },
        "prizes": [
            {
                "position": 1,
                "prize": 1949
            },
            {
                "position": 2,
                "prize": 572
            },
            "… 2 more"
        ]
    }
}

A real response from /v1/races/rc_1P005G7/dividends, captured by calling the live API rather than written by hand.

Response fields

Each field is described once and rendered on every endpoint that returns it, so the wording cannot drift between pages.

Field	Type	What it is
race_id	string	Opaque race identifier. Stable, and safe to store.
course	string	Course name.
date	date	Race date, YYYY-MM-DD.
dividends	object	Tote returns to a one unit stake.
prizes	array	Prize money by finishing position.
position	integer	Finishing position. Null means the runner did not complete or was not published below the placings.

What varies by jurisdiction

Tote dividends are published in some jurisdictions and not others

An absent dividend is a fact about the race rather than a gap in the data, and the endpoint says so instead of returning an error.

Not every jurisdiction publishes a full finishing order

America publishes the placings and nothing below them, so position is null for most of the field. Britain, Ireland, France and South Africa carry a position for the great majority of runners. /v1/countries returns the current figure for each.

Errors this endpoint returns

Code	Status	When
unauthorized	401	No key, or one we do not recognise. Check the header name and that the key has not been rotated from your account page.
outside_window	403	You asked for a date your plan cannot see. The body names the window and the date you asked for. Search endpoints clamp instead of refusing, and report what they actually searched in meta.
not_found	404	The identifier is well formed but nothing has it. Distinct from invalid_id, which means the identifier itself is wrong.
invalid_id	422	The prefix does not match the kind of thing the path expects, or the identifier is malformed. A horse id passed where a race is wanted lands here rather than returning the wrong race.
rate_limited	429	Past your per-minute rate. Retry-After is set, and X-RateLimit-Remaining tells you where you stand on every successful response too.
server_error	500	Ours, not yours. Every response carries a request_id; quote it and we can find the exact request.

Run it live

A real request from your browser straight to api.apihorseracing.com with your own key. Nothing is proxied and nothing is logged by this page.

Your API key

Remembered in this browser so you do not paste it on every page.

race_id

What this is for

Tote returns to a one unit stake, and the prize money by finishing position.

The source publishes these as strings with a currency glued on and place returns comma-joined into a single field. They are normalised here into numbers with a currency alongside and place dividends as an array, so nobody has to parse "13.0 GBP" out of a string.

An absent dividend is a fact about the race, not a gap in our data. Most jurisdictions outside Britain and Ireland publish none, and the endpoint returns a null with a note saying so rather than an error.