Sign in
latestOpenAPI 3.1.02026-08-2258124482.2 KB

2c05e3febd3a

Pro Plan

Race Pro

<h4>Get a race, including runner odds for UK & Ireland races only.</h4><table><tbody><tr><td><b>Min. Required Plan</b></td><td>Pro</td></tr><tr><td><b>Rate Limit</b></td><td>5 requests per second</td></tr></tbody></table>
get/v1/racecards/{race_id}/pro

Path parameters

race_idstring required

Response

Successful Response

race_idstring required

Unique identifier for the race, prefixed rac_.

coursestring required

Racecourse name. Non-GB courses carry a country suffix, e.g. Ballinrobe (IRE).

course_idstring required

Unique identifier for the racecourse, prefixed crs_.

datestring required

Date of the race, YYYY-MM-DD, in local track time.

off_timestring required

Scheduled off time as shown on the racecard, local track time, 12-hour clock without meridiem, e.g. 2:15.

off_dtstring 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_namestring required

Full race title, including sponsor.

distance_roundstring required

Race distance rounded to the nearest furlong, e.g. 7f.

distancestring required

Exact race distance in miles, furlongs and yards, e.g. 0m7f6y. The miles component is always present, including when zero.

distance_fstring required

Exact race distance in furlongs as a decimal string, e.g. 7.0.

regionstring required

Region code for the racecourse, e.g. GB, IRE.

patternstring required

Pattern or graded status where applicable, e.g. Group 1, Listed. Empty for ordinary races.

sex_restrictionstring nullable

Sex restriction on entry, e.g. F&M for fillies and mares. Empty when the race is open.

race_classstring required

Official race class, e.g. Class 3. Empty where the racing authority does not class the race, which includes most Irish racing.

typestring required

Race type, e.g. Flat, Hurdle, Chase, NH Flat.

age_bandstring required

Age restriction on entry, e.g. 2yo, 4yo+.

rating_bandstring required

Official rating band for a handicap, e.g. 0-100. Empty for non-handicaps.

prizestring required

Prize money to the winner, as a formatted string including the currency symbol, e.g. £6,804.

field_sizestring required

Number of declared runners, as a string.

going_detailedstring nullable required

The racecourse's own detailed going description, which may vary by section of track, e.g. GOOD TO FIRM, Good in places. Empty when not published.

rail_movementsstring nullable required

Not populated since June 2026. Always returns an empty string. May return in a future release.

stallsstring nullable required

Stalls position for flat races, e.g. 6f - Inside; Remainder - Centre. Empty when not published or not applicable.

weatherstring nullable required

Weather at the course, e.g. Overcast. Empty when not published.

goingstring required

Standardised official going, e.g. Good To Firm.

surfacestring nullable required

Racing surface, e.g. Turf, AW.

jumpsstring nullable

Description of the obstacles for a jumps race, e.g. 12 hurdles. Empty for flat races.

big_raceboolean nullable

true when the race is one of our featured races.

is_abandonedboolean nullable

true when the race has been abandoned.

tipstring nullable

The name of the horse our analyst tips in this race. Empty when we have no selection.

verdictstring nullable

Our analyst's written verdict on the race. Empty when we have no verdict.

betting_forecaststring nullable

Not populated since June 2026. Always returns an empty string; may return in a future release.

race_statusstring 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.

Example response

{
  "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": ""
}