Deliveries

GET /v1/webhooks/deliveries

What we sent, when, and whether it landed.

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
status	query	string	no	delivered, failed or pending. Omit for all.
event	query	string	no	Restrict to one event type.
limit	query	integer	no	1 to 200. Defaults to 50.
cursor	query	string	no	Opaque. Pass next_cursor from the previous response.

Request

curl https://api.apihorseracing.com/v1/webhooks/deliveries \
  -H "X-API-Key: $AHR_KEY"

$ch = curl_init('https://api.apihorseracing.com/v1/webhooks/deliveries');
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/webhooks/deliveries',
  { 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/webhooks/deliveries",
    headers={"X-API-Key": os.environ["AHR_KEY"]},
).json()

Response

200 OK application/json harvested 8 days ago

{
    "meta": {
        "request_id": "45d70f02f5f176a3",
        "data_as_of": "2026-09-12T05:10:27+00:00",
        "plan": "analyst",
        "window": "2017 → upcoming",
        "count": 0
    },
    "data": {
        "subscriptions": [
            {
                "url": "https://example.com/hooks/racing",
                "events": [
                    "result.received"
                ],
                "active": true,
                "failures": 0,
                "last_ok_at": null
            }
        ],
        "deliveries": [],
        "available_events": {
            "result.received": "A race result has landed.",
            "race.status_changed": "A race moved between scheduled, off, and weighed in.",
            "card.updated": "A racecard changed after publication.",
            "non_runner.declared": "A declared runner was withdrawn."
        }
    }
}

A real response from /v1/webhooks/deliveries, 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

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.
invalid_param	422	A date that is not YYYY-MM-DD, a by= dimension we do not have, or a cursor that did not come from us. The message names the parameter.
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.

status optional

event optional

limit optional

cursor optional

What this is for

What we sent, when, how long it took, what your endpoint returned and how many attempts it needed.

It exists because a webhook that fails silently is worse than no webhook. If your endpoint was down for an hour, this is where you find out which deliveries were lost, rather than discovering a gap in your data a week later and not knowing why.

The response body from your endpoint is kept, truncated, for failed deliveries. A five hundred with your own stack trace in it is usually the fastest possible answer to why the delivery failed.

Common uses

Debugging a subscription that is not working

status=failed. The status code and your own response body are both here.

Backfilling after an outage

Take the race identifiers from the failed deliveries and fetch them directly. We do not replay, so this is the recovery path.