| Min. Required Plan | Free |
| Rate Limit | 1 request per second |
Query by region codes. Get the full list here.
Note: If the course query parameter is specified, this will be ignored.
- `course_ids` string[], nullable — Query by course ids. Get the full list here. - `limit` integer, nullable - `skip` integer, nullable ## Response `200` Successful Response - RacecardsBasicPage - `racecards` RacecardBasic[], required — The matching racecards. - `race_id` string, required — Unique identifier for the race, prefixed `rac_`. - `course` string, required — Racecourse name. Non-GB courses carry a country suffix, e.g. `Ballinrobe (IRE)`. - `date` string, required — Date of the race, `YYYY-MM-DD`, in local track time. - `off_time` string, required — Scheduled off time as shown on the racecard, local track time, 12-hour clock without meridiem, e.g. `2:15`. - `off_dt` string, nullable — Scheduled off time as a timezone-aware ISO 8601 datetime, e.g. `2026-08-04T14:15:00+01:00`. Prefer this over `off_time` and `date` for any time arithmetic. - `race_name` string, required — Full race title, including sponsor. - `distance_f` string, required — Exact race distance in furlongs as a decimal string, e.g. `7.0`. - `region` string, required — Region code for the racecourse, e.g. `GB`, `IRE`. - `pattern` string, required — Pattern or graded status where applicable, e.g. `Group 1`, `Listed`. Empty for ordinary races. - `race_class` string, required — Official race class, e.g. `Class 3`. Empty where the racing authority does not class the race, which includes most Irish racing. - `type` string, required — Race type, e.g. `Flat`, `Hurdle`, `Chase`, `NH Flat`. - `age_band` string, required — Age restriction on entry, e.g. `2yo`, `4yo+`. - `rating_band` string, required — Official rating band for a handicap, e.g. `0-100`. Empty for non-handicaps. - `sex_restriction` string, nullable — Sex restriction on entry, e.g. `F&M` for fillies and mares. Empty when the race is open. - `prize` string, required — Prize money to the winner, as a formatted string including the currency symbol, e.g. `£6,804`. - `field_size` string, required — Number of declared runners, as a string. - `going` string, required — Standardised official going, e.g. `Good To Firm`. - `surface` string, nullable, required — Racing surface, e.g. `Turf`, `AW`. - `runners` AppModelsRacecardsRunnerBasic[], required — Declared runners. Non-runners remain in the array with `number` set to `NR`. - `horse` string, required — Horse name. Non-GB-bred horses carry a country suffix, e.g. `Mephisto (IRE)`. - `horse_id` string, required — Unique identifier for the horse, prefixed `hrs_`. - `age` string, required — Age in years at the date of the race, as a string. - `sex` string, nullable, required — Sex in full, e.g. `gelding`, `filly`, `colt`, `mare`. - `sex_code` string, nullable, required — Single-letter sex code, e.g. `G`, `F`, `C`, `M`. - `colour` string, nullable, required — Coat colour abbreviation, e.g. `b` bay, `gr` grey, `ch` chestnut. - `region` string, required — Region the horse was bred in, e.g. `GB`, `IRE`, `USA`. - `dam` string, required — The horse's dam. - `dam_id` string, required — Unique identifier for the dam, prefixed `dam_`. - `sire` string, required — The horse's sire. - `sire_id` string, required — Unique identifier for the sire, prefixed `sir_`. - `damsire` string, required — The dam's sire. - `damsire_id` string, required — Unique identifier for the damsire, prefixed `dsi_`. - `trainer` string, required — Current trainer of the horse. - `trainer_id` string, required — Unique identifier for the trainer, prefixed `trn_`. - `owner` string, required — Current owner of the horse. - `owner_id` string, required — Unique identifier for the owner, prefixed `own_`. - `number` string, required — Saddlecloth number. `NR` marks a non-runner — check this before treating the entry as a live runner. - `draw` string, required — Stall number for flat races. Empty for jumps racing. - `headgear` string, nullable, required — Headgear worn, as a letter code, e.g. `b` blinkers, `v` visor, `t` tongue tie, `h` hood, `p` cheekpieces. Empty when none. - `lbs` string, required — Weight to be carried, in pounds. - `ofr` string, required — Official handicap rating (the horse's mark). `-` when the horse is unrated. - `jockey` string, required — Booked jockey. A claim is shown in brackets after the name, e.g. `Adam Tracey(7)`. - `jockey_id` string, required — Unique identifier for the jockey, prefixed `jky_`. - `last_run` string, required — Days since the horse last ran. Empty for a horse that has not run before. - `form` string, nullable, required — Recent finishing positions, most recent last. `-` separates seasons and `/` separates years off. Empty for an unraced horse. - `race_status` string, nullable — Current status of the race: `entry` once entries are published, `declared` once final declarations are made, `result` once a result has been published. May be empty on older racecards. - `total` integer, required — Total number of matching records. - `limit` integer, required — The page size applied. - `skip` integer, required — The number of records skipped. - `query` array[], required — The query parameters this response was generated from, echoed back as name/value pairs. - unknown[] - unknown ## Other responses - `404` — Not found - `422` — Validation Error --- [API](https://skmtc.net/theracingapi/apis/the-racing-api.md) · [All operations](https://skmtc.net/theracingapi/apis/the-racing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theracingapi/the-racing-api/revisions/2c05e3febd3a/schema)