Search race reports
Complete
Written UK race reports since 2020. British and Northern Irish racing only.
Examplea real answer from 2026-10-29
{
"data": [],
"meta": {
"request_id": "cffe99c91baff1e4",
"plan": "complete",
"window": "January 2017 to the next 3 days",
"data_as_of": "2026-10-30T08:11:33+00:00",
"count": 0
}
}Parameters
| Name | In | Type | Required | What it does |
|---|---|---|---|---|
date_from | query | date | no | From this UK day, YYYY-MM-DD. Held to your plan's window; meta.searched says what was used. |
date_to | query | date | no | To this UK day, YYYY-MM-DD. Held to your plan's window. |
course_id | query | id | no | Our id for the course, as other answers give it (cr_ and eight characters). |
limit | query | integer | no | How many rows in one answer, 1 to 100. Default 25. |
cursor | query | string | no | next_cursor from the previous answer, to read the next rows. Never build one. |
Returns
A list in data, one row each, with meta.count. Every answer carries meta: request_id, plan, window and data_as_of.
Each field is listed here, read from the example answer, once the data feed is connected.
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. |