---
title: "Racecards Pro"
method: GET
path: "/v1/racecards/pro"
tags: ["Racecards", "Pro Plan"]
---

# Racecards Pro

`GET /v1/racecards/pro`

<h4>Get future and historical racecards, including runner odds for UK & Irish racing.</h4><table><tbody><tr><td><b>Min. Required Plan</b></td><td>Pro</td></tr><tr><td><b>Rate Limit</b></td><td>2 requests per second</td></tr></tbody></table><p>ℹ️ Historical racecards are available from 2023-01-23, when our tracking began. Future racecards are available up to 1 week in advance.</p>

## Query parameters

- `date` string, nullable — Query racecards by date with format YYYY-MM-DD (e.g 2023-04-05)
- `region_codes` string[], nullable — <p>Query by region codes. Get the full list <a href='https://api.theracingapi.com/documentation#tag/Courses/operation/list_regions_v1_courses_regions_get'>here</a>.</p><p>Note: If the course query parameter is specified, this will be ignored.</p>
- `course_ids` string[], nullable — Query by course ids. Get the full list <a href='https://api.theracingapi.com/documentation#tag/Courses/operation/list_courses_v1_courses_get'>here</a>.
- `limit` integer, nullable
- `skip` integer, nullable

## Response `200`

Successful Response

- RacecardsOddsProPage
  - `racecards` RacecardOddsPro[], required
    - `race_id` string, required
    - `course` string, required
    - `course_id` string, required
    - `date` string, required
    - `off_time` string, required
    - `off_dt` string, nullable
    - `race_name` string, required
    - `distance_round` string, required
    - `distance` string, required
    - `distance_f` string, required
    - `region` string, required
    - `pattern` string, required
    - `sex_restriction` string, nullable
    - `race_class` string, required
    - `type` string, required
    - `age_band` string, required
    - `rating_band` string, required
    - `prize` string, required
    - `field_size` string, required
    - `going_detailed` string, nullable, required
    - `rail_movements` string, nullable, required
    - `stalls` string, nullable, required
    - `weather` string, nullable, required
    - `going` string, required
    - `surface` string, nullable, required
    - `jumps` string, nullable
    - `runners` RunnerOddsPro[], required
      - `horse_id` string, required
      - `horse` string, required
      - `dob` string, nullable, required
      - `age` string, nullable, required
      - `sex` string, nullable, required
      - `sex_code` string, nullable, required
      - `colour` string, nullable, required
      - `region` string, nullable, required
      - `breeder` string, nullable, required
      - `dam` string, required
      - `dam_id` string, required
      - `dam_region` string, nullable
      - `sire` string, required
      - `sire_id` string, required
      - `sire_region` string, nullable
      - `damsire` string, required
      - `damsire_id` string, required
      - `damsire_region` string, nullable
      - `trainer` string, required
      - `trainer_id` string, required
      - `trainer_location` string, nullable
      - `trainer_14_days` RunnerTrainer14Days
        - `runs` string, nullable
        - `wins` string, nullable
        - `percent` string, nullable
      - `owner` string, required
      - `owner_id` string, required
      - `prev_trainers` RunnerPrevTrainer[], nullable
        - `trainer` string, nullable
        - `trainer_id` string, nullable
        - `change_date` string, nullable
      - `prev_owners` RunnerPrevOwner[], nullable
        - `owner` string, nullable
        - `owner_id` string, nullable
        - `change_date` string, nullable
      - `comment` string, nullable
      - `spotlight` string, nullable
      - `quotes` RunnerQuote[], nullable
        - `date` string, nullable
        - `horse` string, nullable
        - `horse_id` string, nullable
        - `race` string, nullable
        - `race_id` string, nullable
        - `course` string, nullable
        - `course_id` string, nullable
        - `distance_f` string, nullable
        - `distance_y` string, nullable
        - `quote` string, nullable
      - `stable_tour` RunnerStableTour[], nullable
        - `quote` string, nullable
      - `medical` RunnerMedical[], nullable
        - `date` string, nullable
        - `type` string, nullable
      - `number` string, required
      - `draw` string, required
      - `headgear` string, nullable
      - `headgear_run` string, nullable
      - `wind_surgery` string, nullable
      - `wind_surgery_run` string, nullable
      - `past_results_flags` string[], nullable
      - `lbs` string, required
      - `ofr` string, required
      - `rpr` string, required
      - `ts` string, required
      - `performance_rating` string, nullable
      - `speed_rating` string, nullable
      - `jockey` string, required
      - `jockey_id` string, required
      - `silk_url` string, nullable
      - `last_run` string, required
      - `form` string, nullable, required
      - `trainer_rtf` string, nullable, required
      - `odds` OddsHistory[], nullable
        - `bookmaker` string, required
        - `fractional` string, required
        - `decimal` string, required
        - `ew_places` string, required
        - `ew_denom` string, required
        - `updated` string, required
        - `history` unknown[], nullable
          - unknown
    - `big_race` boolean, nullable
    - `is_abandoned` boolean, nullable
    - `tip` string, nullable
    - `verdict` string, nullable
    - `betting_forecast` string, nullable
    - `race_status` string, nullable
  - `total` integer, required
  - `limit` integer, required
  - `skip` integer, required
  - `query` array[], required
    - 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/versions/96bb5fc22e4f/schema)