# HorseRacingAPI

> Official horse racing results as data. 19 REST endpoints covering the United States, Great Britain, Ireland, France and South Africa since 1 January 2022: every race with its conditions and every runner in finishing order, with horse, jockey, trainer and owner.
> Factual data only: no predictions, ratings or tips.

## Complete reference

- [Full manual, one file](https://horseracingapi.org/documentation/manual.md): every endpoint, parameter, sample response and guide in a single markdown document.
- [OpenAPI](https://horseracingapi.org/openapi.json): machine-readable API description.
- [MCP server](https://horseracingapi.org/mcp): Model Context Protocol endpoint.

## Agent skill

- [HorseRacingAPI agent skill](https://horseracingapi.org/.well-known/agent-skills/horseracingapi/SKILL.md): how agents use HorseRacingAPI. Index: https://horseracingapi.org/.well-known/agent-skills/index.json

## Guides

- [Quick start](https://horseracingapi.org/documentation/quick-start): A key, your first call and what comes back, in three minutes.
- [Authentication](https://horseracingapi.org/documentation/authentication): Your key, the two ways to send it, and rotating it.
- [Plans and limits](https://horseracingapi.org/documentation/plans-and-limits): What each plan reads, its rate limit and its allowance.
- [Pagination](https://horseracingapi.org/documentation/pagination): Pages on lists of known length, a cursor on searches.
- [Errors](https://horseracingapi.org/documentation/errors): Every error code, and what to do about each.
- [Results and races](https://horseracingapi.org/documentation/results-and-races): Days of results, single races, the newest results and race search.
- [Meetings](https://horseracingapi.org/documentation/meetings): Every meeting on a day, and one meeting with its races.
- [Horses and jockeys](https://horseracingapi.org/documentation/horses-and-jockeys): Finding a horse or a jockey, their records and their last ten runs.
- [Trainers and owners](https://horseracingapi.org/documentation/trainers-and-owners): Opening a trainer or an owner from any result.
- [Courses and nations](https://horseracingapi.org/documentation/courses-and-nations): The five nations, every course in them, and what each publishes.
- [MCP server](https://horseracingapi.org/documentation/mcp): Ask for results in plain English from Claude, ChatGPT, Cursor or Claude Code.
- [Agent skill](https://horseracingapi.org/documentation/agent-skill): One file that teaches an agent the whole API.
- [Changelog](https://horseracingapi.org/documentation/changelog): What changed, newest first.
- [MCP tools](https://horseracingapi.org/documentation/mcp-tools): every tool the MCP server offers.

## Endpoints

- [GET /v1/results/latest](https://horseracingapi.org/documentation/results-latest): Latest results
- [GET /v1/results/yesterday](https://horseracingapi.org/documentation/results-yesterday): Yesterday's results
- [GET /v1/results/{date}](https://horseracingapi.org/documentation/results-date): Results by date
- [GET /v1/races/search](https://horseracingapi.org/documentation/races-search): Search races
- [GET /v1/races/{race_id}](https://horseracingapi.org/documentation/races-race_id): Race detail
- [GET /v1/meetings/{date}](https://horseracingapi.org/documentation/meetings-date): Meetings by date
- [GET /v1/meetings/{meeting_id}](https://horseracingapi.org/documentation/meetings-meeting_id): Meeting
- [GET /v1/horses/search](https://horseracingapi.org/documentation/horses-search): Search horses
- [GET /v1/horses/{horse_id}](https://horseracingapi.org/documentation/horses-horse_id): Horse profile
- [GET /v1/horses/{horse_id}/form](https://horseracingapi.org/documentation/horses-horse_id-form): Last ten runs
- [GET /v1/jockeys/search](https://horseracingapi.org/documentation/jockeys-search): Search jockeys
- [GET /v1/jockeys/{jockey_id}](https://horseracingapi.org/documentation/jockeys-jockey_id): Jockey profile
- [GET /v1/jockeys/{jockey_id}/rides](https://horseracingapi.org/documentation/jockeys-jockey_id-rides): Last ten rides
- [GET /v1/trainers/{trainer_id}](https://horseracingapi.org/documentation/trainers-trainer_id): Trainer profile
- [GET /v1/owners/{owner_id}](https://horseracingapi.org/documentation/owners-owner_id): Owner profile
- [GET /v1/countries](https://horseracingapi.org/documentation/countries): Nations
- [GET /v1/courses](https://horseracingapi.org/documentation/courses): Courses
- [GET /v1/courses/{course_id}](https://horseracingapi.org/documentation/courses-course_id): Course
- [GET /v1/usage](https://horseracingapi.org/documentation/usage): Your usage