HORSERACINGAPI --:--:-- UTC Sign inFree key

Documentation / Meetings

Meetings by date

Results plan

Every meeting on a day, with its going and how many races it held.

GET/v1/meetings/{date}
Try itRuns against the real API with your key
No key yet? The free key is made the moment you sign in, and appears here by itself.Get a free key
required
optional
optional
optional
https://api.horseracingapi.org/v1/meetings/2026-10-20?country=FR

Press Run to see the live answer here.

curl "https://api.horseracingapi.org/v1/meetings/2026-10-20?country=FR" \
  -H "X-API-Key: hra_live_…"

Parameters

NameIn · typeRequiredWhat it is
datepath · dateYesThe day, YYYY-MM-DD, from 2022-01-01 to today.
countryquery · stringNoOnly this nation: USA, GB, IRE, FR or RSA.USAGBIREFRRSA
per_pagequery · integerNoHow many to a page, 1 to 100. Default 50.
pagequery · integerNoWhich page, from 1.

Returns

FieldTypeWhat it holds
meeting_idstringOur own id for the meeting.
course_idstringThe course.
coursestringThe course name.
countrystringUSA, GB, IRE, FR or RSA.
datestringThe course's own calendar day.
goingstringThe going for the meeting.
surfacestringTurf, Dirt or All Weather.
racesintegerHow many races it held.

Example answer

{
  "data": [
    {
      "meeting_id": "mt_31tcke0x",
      "course_id": "cr_t6pv23df",
      "course": "Bordeaux Le Bouscat",
      "country": "FR",
      "date": "2026-10-20",
      "going": "Soft",
      "surface": "Turf",
      "races": 8
    },
    {
      "meeting_id": "mt_mttc2aka",
      "course_id": "cr_p3dbgp5x",
      "course": "Clairefontaine",
      "country": "FR",
      "date": "2026-10-20",
      "going": "Heavy",
      "surface": "Turf",
      "races": 9
    },
    "… 1 more"
  ],
  "meta": {
    "plan": "results",
    "window": "2022-01-01 to now",
    "data_as_of": "2026-10-21T21:19:06Z",
    "date": "2026-10-20",
    "count": 3,
    "page": 1,
    "per_page": 50,
    "total": 3,
    "total_pages": 1,
    "next_page": null,
    "prev_page": null,
    "next_cursor": null
  }
}

Errors

StatusCodeWhen
400bad_requestA value is the wrong shape, or the key was sent in the address.
401unauthorizedNo key, or one we do not know.
403upgrade_requiredYour plan does not open this endpoint. It is on the Results plan.
404not_foundA date before 1 January 2022.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedOver your calls a minute. Retry after the seconds given.
429quota_exceededYour allowance is used. The answer says when it comes back.
503server_errorOn our side. Try again in a minute.