v7

OpenAPI 3.1.02026-08-0358124623.5 KB

Racecards

Pro Plan

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>

get/v1/racecards/pro

Query parameters

datestring nullable

Query racecards by date with format YYYY-MM-DD (e.g 2023-04-05)

region_codesstring[] 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_idsstring[] 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>.

limitinteger nullable

skipinteger nullable

Response

Successful Response

totalinteger required

limitinteger required

skipinteger required

Example response

{
  "racecards": [
    {
      "age_band": "3yo+",
      "big_race": false,
      "course": "Sha Tin",
      "course_id": "crs_10816",
      "date": "2026-01-11",
      "distance": "6f",
      "distance_f": "6.0",
      "distance_round": "6f",
      "field_size": "12",
      "going": "Good",
      "going_detailed": "TURF: GOOD TO FIRM",
      "is_abandoned": false,
      "jumps": "",
      "off_dt": "2026-01-11T05:00:00+00:00",
      "off_time": "5:00",
      "pattern": "",
      "prize": "£62,459",
      "race_class": "",
      "race_id": "rac_11845223",
      "race_name": "Wu Kai Sha Handicap (Div I) (Class 4) (3yo+) (Course C+3) (Turf)",
      "race_status": "",
      "rating_band": "",
      "region": "HK",
      "runners": [
        {
          "age": "9",
          "breeder": "Scea Haras De Saint Pair",
          "colour": "b/br",
          "comment": "Below his best of late but the yard is in form; capable of better on a going day.",
          "dam": "Trois Lunes",
          "dam_id": "dam_5583571",
          "dam_region": "FR",
          "damsire": "Manduro",
          "damsire_id": "dsi_4247215",
          "damsire_region": "GER",
          "dob": "2014-02-27",
          "draw": "9",
          "form": "60500-",
          "headgear": "",
          "headgear_run": "",
          "horse": "Trais Fluors",
          "horse_id": "hrs_8192583",
          "jockey": "Rose Dawes(5)",
          "jockey_id": "jky_301152",
          "last_run": "192",
          "lbs": "139",
          "medical": [],
          "number": "2",
          "odds": [
            {
              "bookmaker": "Bet365",
              "decimal": "4.33",
              "ew_denom": "5",
              "ew_places": "3",
              "fractional": "10/3",
              "history": [],
              "updated": "2023-05-02 12:36:43"
            },
            {
              "bookmaker": "Betfair Exchange",
              "decimal": "4.5",
              "ew_denom": "",
              "ew_places": "",
              "fractional": "7/2",
              "history": [],
              "updated": "2023-05-02 12:36:43"
            }
          ],
          "ofr": "74",
          "owner": "M Channon",
          "owner_id": "own_31504",
          "past_results_flags": [],
          "performance_rating": "88",
          "prev_owners": [
            {
              "change_date": "2021-09-06",
              "owner": "Lee Harris",
              "owner_id": "own_1182044"
            },
            {
              "change_date": "2021-03-22",
              "owner": "Robert Ng",
              "owner_id": "own_466920"
            }
          ],
          "prev_trainers": [
            {
              "change_date": "2023-03-24",
              "trainer": "Mick Channon",
              "trainer_id": "trn_42084"
            },
            {
              "change_date": "2021-03-22",
              "trainer": "K J Condon",
              "trainer_id": "trn_137160"
            },
            {
              "change_date": "2019-10-23",
              "trainer": "A Fabre",
              "trainer_id": "trn_9837"
            }
          ],
          "region": "GB",
          "sex": "gelding",
          "sex_code": "G",
          "silk_url": "https://silks.theracingapi.com/silk?body=solid:ce1126&sleeves=solid:ffffff&cap=solid:ce1126",
          "sire": "Dansili",
          "sire_id": "sir_3527125",
          "sire_region": "GB",
          "speed_rating": "95",
          "trainer": "Jack Channon",
          "trainer_14_days": {
            "percent": "31",
            "runs": "16",
            "wins": "5"
          },
          "trainer_id": "trn_361449",
          "trainer_location": "West Ilsley, Berks",
          "trainer_rtf": "71",
          "wind_surgery": "",
          "wind_surgery_run": ""
        }
      ],
      "sex_restriction": "",
      "stalls": "",
      "surface": "Turf",
      "tip": "Trais Fluors",
      "type": "Flat",
      "verdict": "Trais Fluors looks well treated on these terms and is taken to outpoint the in-form rivals.",
      "weather": ""
    }
  ]
}