Sign in

v7

OpenAPI 3.1.02026-08-0358124623.5 KB
Racecards
Free Plan

Racecards Free

<h4>Get racecards for today and tomorrow (basic data only)</h4><table><tbody><tr><td><b>Min. Required Plan</b></td><td>Free</td></tr><tr><td><b>Rate Limit</b></td><td>1 request per second</td></tr></tbody></table>
get/v1/racecards/free

Query parameters

daystring nullable

Query racecards by day:<br> today, tomorrow

Query racecards by day:<br> today, tomorrow

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

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": "4yo+",
      "course": "Brighton",
      "date": "2023-05-02",
      "distance_f": "7.0",
      "field_size": "9",
      "going": "Good To Firm",
      "off_dt": "2023-05-02T13:50:00+01:00",
      "off_time": "1:50",
      "pattern": "",
      "prize": "£4,606",
      "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",
          "colour": "b",
          "dam": "Lerici",
          "dam_id": "dam_4823441",
          "damsire": "Woodman",
          "damsire_id": "dsi_2126229",
          "draw": "8",
          "form": "3-7880",
          "headgear": "",
          "horse": "Pistoletto",
          "horse_id": "hrs_18092480",
          "jockey": "Adam Tracey(7)",
          "jockey_id": "jky_301290",
          "last_run": "25",
          "lbs": "140",
          "number": "1",
          "ofr": "75",
          "owner": "J A Thompson & S Russell",
          "owner_id": "own_1227828",
          "region": "USA",
          "sex": "gelding",
          "sex_code": "G",
          "sire": "War Front",
          "sire_id": "sir_4544750",
          "trainer": "John Ryan",
          "trainer_id": "trn_160758"
        }
      ],
      "sex_restriction": "",
      "surface": "Turf",
      "type": "Flat"
    }
  ]
}