Racecards
Standard Plan
<h4>Get a race scheduled for today or tomorrow (or if classified as a 'big race'), including runner odds for UK & Ireland races.</h4><table><tbody><tr><td><b>Min. Required Plan</b></td><td>Standard</td></tr><tr><td><b>Rate Limit</b></td><td>5 requests per second</td></tr></tbody></table>
get/v1/racecards/{race_id}/standard

Request

  • Base URL: https://api.theracingapi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.theracingapi.com/v1/racecards/{race_id}/standard
  • Auth: HTTP basic

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 display string with the currency symbol where the source gives one (e.g. £6,804, €9,450); see prize_currency.

prize_currencystring

ISO 4217 code of prize (GBP, EUR, USD, …). Empty when prize is empty or the record is not carried (pre-2026-07-07 / non-source_3). For records without it: GB prizes are GBP, Irish prizes (the IRE region, including Northern Ireland) are EUR, and every other region's prizes are GBP, converted from the local currency at a rate that cannot be recovered. From 2026-07-07 Hong Kong prizes are quoted in USD (converted by the source), not HKD, and Northern Ireland meetings in EUR.

field_sizestring required

Number of declared runners, as a string. Non-runners and reserves are not counted.

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, weighed once weights are published, declared once final declarations are made, result once a result has been published, abandoned when the race was never run, void when the race was run but declared void by the stewards (the racecard stands, no result will be published, and is_abandoned is false). To exclude races with no forthcoming result, exclude both abandoned and void. May be empty on older racecards.

Example response

{
  "age_band": "4yo+",
  "big_race": false,
  "course": "Brighton",
  "course_id": "crs_182",
  "date": "2023-05-02",
  "distance": "6f210y",
  "distance_f": "7.0",
  "distance_round": "7f",
  "field_size": "9",
  "going": "Good To Firm",
  "going_detailed": "",
  "is_abandoned": false,
  "jumps": "",
  "off_dt": "2023-05-02T13:50:00+01:00",
  "off_time": "1:50",
  "pattern": "",
  "prize": "£4,606",
  "prize_currency": "GBP",
  "race_class": "Class 5",
  "race_id": "rac_10880272",
  "race_name": "At The Races App Form Study Apprentice Handicap",
  "race_status": "",
  "rating_band": "0-75",
  "region": "GB",
  "runners": [
    {
      "age": "6",
      "breeder": "Tada Nobutaka",
      "colour": "b",
      "comment": "Course-and-distance form; acts on the ground and is a leading player on these terms.",
      "dam": "Lerici",
      "dam_id": "dam_4823441",
      "dam_region": "USA",
      "damsire": "Woodman",
      "damsire_id": "dsi_2126229",
      "damsire_region": "USA",
      "dob": "2017-04-22",
      "draw": "8",
      "form": "3-7880",
      "headgear": "",
      "headgear_run": "",
      "horse": "Pistoletto",
      "horse_id": "hrs_18092480",
      "jockey": "Adam Tracey(7)",
      "jockey_id": "jky_301290",
      "last_run": "25",
      "lbs": "140",
      "medical": [],
      "number": "1",
      "odds": [
        {
          "bookmaker": "Bet365",
          "decimal": "9",
          "ew_denom": "5",
          "ew_places": "3",
          "fractional": "8",
          "updated": "2023-05-02 12:36:43"
        },
        {
          "bookmaker": "Paddy Power",
          "decimal": "8.5",
          "ew_denom": "5",
          "ew_places": "3",
          "fractional": "15/2",
          "updated": "2023-05-02 12:36:43"
        }
      ],
      "ofr": "75",
      "owner": "J A Thompson & S Russell",
      "owner_id": "own_1227828",
      "past_results_flags": [],
      "performance_rating": "92",
      "prev_owners": [
        {
          "change_date": "2021-08-07",
          "owner": "G McGladery, J A Thompson & S Russell",
          "owner_id": "own_1191676"
        }
      ],
      "prev_trainers": [
        {
          "change_date": "2020-09-26",
          "trainer": "A P O'Brien",
          "trainer_id": "trn_71802"
        }
      ],
      "region": "USA",
      "sex": "gelding",
      "sex_code": "G",
      "silk_url": "https://silks.theracingapi.com/silk?body=solid:ce1126&sleeves=solid:ffffff&cap=solid:ce1126",
      "sire": "War Front",
      "sire_id": "sir_4544750",
      "sire_region": "USA",
      "speed_rating": "97",
      "trainer": "John Ryan",
      "trainer_14_days": {
        "percent": "0",
        "runs": "5",
        "wins": "0"
      },
      "trainer_id": "trn_160758",
      "trainer_location": "Newmarket, Suffolk",
      "trainer_rtf": "",
      "wind_surgery": "",
      "wind_surgery_run": ""
    }
  ],
  "sex_restriction": "",
  "stalls": "",
  "surface": "Turf",
  "tip": "Pistoletto",
  "type": "Flat",
  "verdict": "Pistoletto sets the standard on these terms and is taken to confirm the pick of his form.",
  "weather": ""
}

Changes

    • info

      added the optional property to the response with the status

    • info

      response property runners/items/quotes deprecated

    • info

      response property runners/items/rpr deprecated

    • info

      response property runners/items/spotlight deprecated

    • info

      response property runners/items/stable_tour deprecated

    • info

      response property runners/items/ts deprecated