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

# Racecards Free

`GET /v1/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>

## Query parameters

- `day` string, nullable — Query racecards by day:<br> today, tomorrow
- `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

- RacecardsBasicPage
  - `racecards` RacecardBasic[], required
    - `race_id` string, required
    - `course` string, required
    - `date` string, required
    - `off_time` string, required
    - `off_dt` string, nullable
    - `race_name` string, required
    - `distance_f` string, required
    - `region` string, required
    - `pattern` string, required
    - `race_class` string, required
    - `type` string, required
    - `age_band` string, required
    - `rating_band` string, required
    - `sex_restriction` string, nullable
    - `prize` string, required
    - `field_size` string, required
    - `going` string, required
    - `surface` string, nullable, required
    - `runners` AppModelsRacecardsRunnerBasic[], required
      - `horse` string, required
      - `horse_id` string, required
      - `age` string, required
      - `sex` string, nullable, required
      - `sex_code` string, nullable, required
      - `colour` string, nullable, required
      - `region` string, required
      - `dam` string, required
      - `dam_id` string, required
      - `sire` string, required
      - `sire_id` string, required
      - `damsire` string, required
      - `damsire_id` string, required
      - `trainer` string, required
      - `trainer_id` string, required
      - `owner` string, required
      - `owner_id` string, required
      - `number` string, required
      - `draw` string, required
      - `headgear` string, nullable, required
      - `lbs` string, required
      - `ofr` string, required
      - `jockey` string, required
      - `jockey_id` string, required
      - `last_run` string, required
      - `form` string, nullable, required
    - `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)