# The Racing API

> High-performance horse racing data API for application development, statistical analysis, betting models and research, and ML/LLM/AI agent integrations. Complete coverage of UK, Irish and Hong Kong racing plus global coverage of group-level races and selected handicaps. JSON REST API with HTTP Basic Auth, and a hosted MCP server for AI assistants.

The Racing API serves racecards, results, bookmaker odds, and statistical analysis of
horses, jockeys, trainers, owners and breeding from a global horse racing database.
Today's racecards, odds and results update every 3 minutes; tomorrow's every 15 minutes;
future racecards daily. Requests are rate limited to 5 per second by default (per-endpoint
limits are noted in the documentation).

Built for developers, racing enthusiasts, analysts and small companies. Use by betting
operators and sportsbooks is prohibited — see the Terms of Service.

## Important Links

- [Website](https://www.theracingapi.com/): plans, subscriptions and account dashboard
- [API Documentation](https://api.theracingapi.com/documentation): interactive reference for every endpoint
- [OpenAPI Specification (JSON)](https://api.theracingapi.com/openapi.json)
- [Data Coverage](https://www.theracingapi.com/data-coverage): coverage breakdown by year and region
- [MCP Server Setup](https://www.theracingapi.com/tools/mcp): connect Claude, ChatGPT, Gemini and other AI tools
- [FAQ](https://www.theracingapi.com/faq)
- [Service Status](https://status.theracingapi.com/)
- [Terms of Service](https://www.theracingapi.com/terms-of-service)
- [Privacy Policy](https://www.theracingapi.com/privacy-policy)
- Support: support@theracingapi.com

## Getting Started

1. Subscribe at https://www.theracingapi.com/#subscribe (a Free plan is available).
2. Log in to the dashboard and find your API username and password under **My Account**.
3. Authenticate with **HTTP Basic Auth** — the API does not use API-key headers or bearer tokens.

Base URL: `https://api.theracingapi.com/v1`

```
curl -u "USERNAME:PASSWORD" "https://api.theracingapi.com/v1/courses"
```

```python
import requests
resp = requests.get(
    "https://api.theracingapi.com/v1/racecards/free",
    auth=("USERNAME", "PASSWORD"),
)
```

## AI & LLM Integration

The service is designed for AI integrations: feeding racecards, results and form into
LLMs, agents, betting models and research pipelines.

- **MCP server**: `https://mcp.theracingapi.com` — gives AI assistants direct access to
  racecards, results, form analysis and jockey/trainer statistics. Web interfaces
  (claude.ai, chatgpt.com, gemini.google.com) authenticate via OAuth; CLIs and APIs use
  HTTP header auth. Setup guides: https://www.theracingapi.com/tools/mcp
- The full OpenAPI specification above is the authoritative, machine-readable contract
  for code generation and tool definitions.

## Plans & Pricing

### Free — £0/month

- Daily racecards (basic data)
- Results for all races on daily racecards (basic data)
- Documentation: https://api.theracingapi.com/documentation#tag/Free-Plan

### Basic — £27.99/month

- Daily advanced racecards
- Results for all races on daily racecards
- Historical results for each horse on daily racecards
- Horse distance time analysis endpoint with win percentage, a/e and 1 unit profit/loss
- Documentation: https://api.theracingapi.com/documentation#tag/Basic-Plan

### Standard — £59.99/month

- Daily advanced racecards, with 20+ bookmaker odds for UK & IRE
- Results for all races on daily racecards
- Historical results for each horse on daily racecards
- Historical results with advanced queries, for all races in the last 12 months
- Search horses, jockeys, trainers, owners and more
- All analysis endpoints with win percentage, a/e and 1 unit profit/loss
- Regular API and feature updates
- Documentation: https://api.theracingapi.com/documentation#tag/Standard-Plan

### Pro — £99.99/month

- Past & future advanced racecards, with 20+ bookmaker odds for UK & IRE
- Results for all races on daily racecards
- Historical results for each horse on daily racecards
- Historical results with advanced queries, for all races in the last 12 months
- Search horses, jockeys, trainers, owners and more
- All analysis endpoints with win percentage, a/e and 1 unit profit/loss
- Historical results with advanced queries, for any horse, jockey, trainer, owner, sire, dam or damsire
- Horse breeding info, dob, sex and colour
- Odds change history from market open for each runner (UK & IRE)
- Regular API and feature updates
- Priority technical support
- Documentation: https://api.theracingapi.com/documentation#tag/Pro-Plan

Billing is monthly via Stripe; plans can be upgraded, downgraded or cancelled from the
dashboard at any time. Current pricing is always shown at https://www.theracingapi.com/.

## Historical Results Add-on

- **Pro Plan Historical Results**: The historical results add-on removes the 12 month restriction on the results endpoint, allowing you to access the complete Core API historical results database. Perfect for statistical analysis, form study, and machine learning applications.


## Regional Add-ons (deprecated)

The regional add-ons are **deprecated and no longer sold** — existing subscribers retain
access, but they are not available to new subscribers. Listed for reference only:

- **Australia Racing Data**: The Australia data add-on provides full coverage of Australian racing with 12 months historical data out of the box and ongoing coverage. Available at £49.99/month on any plan, it gives you access to a separate dataset with complete coverage of thoroughbred Australian horse racing. The data models differ from the core dataset and are accessed via dedicated Australia endpoints.

- **North America Racing Data**: The North America data add-on provides full coverage of US and Canadian racing from July 2023. Available at £49.99/month on any plan, it gives you access to a separate dataset with complete coverage of thoroughbred US horse racing. The data models differ from the core dataset and are accessed via dedicated North America endpoints.

- **Australia Historical Results**: The Australia historical results add-on removes the 12 month restriction on all Australia racing data add-on endpoints, allowing you to access the full Australian racing database going back to January 2000. Ideal for Australian market analysis and historical form study.


## API Endpoint Index

Generated from the live OpenAPI specification.

### Courses

- `GET /v1/courses` — Courses (Free plan and above)
- `GET /v1/courses/regions` — Regions (Free plan and above)

### Dams

- `GET /v1/dams/search` — Dam Search (Standard plan and above)
- `GET /v1/dams/{dam_id}/analysis/classes` — Dam Progeny Class Analysis (Standard plan and above)
- `GET /v1/dams/{dam_id}/analysis/distances` — Dam Progeny Distance Analysis (Standard plan and above)
- `GET /v1/dams/{dam_id}/results` — Dam Progeny Results (Pro plan only)

### Damsires

- `GET /v1/damsires/search` — Damsire Search (Standard plan and above)
- `GET /v1/damsires/{damsire_id}/analysis/classes` — Damsire Grandoffspring Class Analysis (Standard plan and above)
- `GET /v1/damsires/{damsire_id}/analysis/distances` — Damsire Grandoffspring Distance Analysis (Standard plan and above)
- `GET /v1/damsires/{damsire_id}/results` — Damsire Grandoffspring Results (Pro plan only)

### Horses

- `GET /v1/horses/search` — Horse Search (Standard plan and above)
- `GET /v1/horses/{horse_id}/analysis/distance-times` — Horse Distance Time Analysis (Basic plan and above)
- `GET /v1/horses/{horse_id}/pro` — Horse Pro (Pro plan only)
- `GET /v1/horses/{horse_id}/results` — Horse Results (Pro plan only)
- `GET /v1/horses/{horse_id}/standard` — Horse Standard (Standard plan and above)

### Jockeys

- `GET /v1/jockeys/search` — Jockey Search (Standard plan and above)
- `GET /v1/jockeys/{jockey_id}/analysis/courses` — Jockey Course Analysis (Standard plan and above)
- `GET /v1/jockeys/{jockey_id}/analysis/distances` — Jockey Distance Analysis (Standard plan and above)
- `GET /v1/jockeys/{jockey_id}/analysis/owners` — Jockey Owner Analysis (Standard plan and above)
- `GET /v1/jockeys/{jockey_id}/analysis/trainers` — Jockey Trainer Analysis (Standard plan and above)
- `GET /v1/jockeys/{jockey_id}/results` — Jockey Results (Pro plan only)

### Odds

- `GET /v1/odds/{race_id}/{horse_id}` — Odds Runner (Pro plan only)

### Owners

- `GET /v1/owners/search` — Owner Search (Standard plan and above)
- `GET /v1/owners/{owner_id}/analysis/courses` — Owner Course Analysis (Standard plan and above)
- `GET /v1/owners/{owner_id}/analysis/distances` — Owner Distance Analysis (Standard plan and above)
- `GET /v1/owners/{owner_id}/analysis/jockeys` — Owner Jockey Analysis (Standard plan and above)
- `GET /v1/owners/{owner_id}/analysis/trainers` — Owner Trainer Analysis (Standard plan and above)
- `GET /v1/owners/{owner_id}/results` — Owner Results (Pro plan only)

### Racecards

- `GET /v1/racecards/basic` — Racecards Basic (Basic plan and above)
- `GET /v1/racecards/big-races` — Racecards Big Races (Standard plan and above)
- `GET /v1/racecards/free` — Racecards Free (Free plan and above)
- `GET /v1/racecards/pro` — Racecards Pro (Pro plan only)
- `GET /v1/racecards/standard` — Racecards Standard (Standard plan and above)
- `GET /v1/racecards/summaries` — Racecards Summaries (Basic plan and above)
- `GET /v1/racecards/{horse_id}/results` — Racecard Horse Results (Basic plan and above)
- `GET /v1/racecards/{race_id}/pro` — Race Pro (Pro plan only)
- `GET /v1/racecards/{race_id}/standard` — Race Standard (Standard plan and above)

### Results

- `GET /v1/results` — Results (Standard plan and above)
- `GET /v1/results/today` — Results Today (Basic plan and above)
- `GET /v1/results/today/free` — Results Today Free (Free plan and above)
- `GET /v1/results/{race_id}` — Result (Standard plan and above)

### Sires

- `GET /v1/sires/search` — Sire Search (Standard plan and above)
- `GET /v1/sires/{sire_id}/analysis/classes` — Sire Progeny Class Analysis (Standard plan and above)
- `GET /v1/sires/{sire_id}/analysis/distances` — Sire Progeny Distance Analysis (Standard plan and above)
- `GET /v1/sires/{sire_id}/results` — Sire Progeny Results (Pro plan only)

### Trainers

- `GET /v1/trainers/search` — Trainer Search (Standard plan and above)
- `GET /v1/trainers/{trainer_id}/analysis/courses` — Trainer Course Analysis (Standard plan and above)
- `GET /v1/trainers/{trainer_id}/analysis/distances` — Trainer Distance Analysis (Standard plan and above)
- `GET /v1/trainers/{trainer_id}/analysis/horse-age` — Trainer Horse Age Analysis (Standard plan and above)
- `GET /v1/trainers/{trainer_id}/analysis/jockeys` — Trainer Jockey Analysis (Standard plan and above)
- `GET /v1/trainers/{trainer_id}/analysis/owners` — Trainer Owner Analysis (Standard plan and above)
- `GET /v1/trainers/{trainer_id}/results` — Trainer Results (Pro plan only)


---

This file is generated dynamically: pricing comes from the live billing system and the
endpoint index from the live OpenAPI specification, cached for up to 12 hours. Content
here tracks the production service automatically as plans and endpoints change.