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

Documentation / Meetings

Meeting

A meeting and every race run at it.

GET/v1/meetings/{meeting_id}
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
https://api.horseracingapi.org/v1/meetings/mt_31tcke0x

Press Run to see the live answer here.

curl "https://api.horseracingapi.org/v1/meetings/mt_31tcke0x" \
  -H "X-API-Key: hra_live_…"

Parameters

NameIn · typeRequiredWhat it is
meeting_idpath · stringYesThe meeting.

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.
racesarrayEvery race, with its conditions. Open a race for its finishing order.

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": [
      {
        "race_id": "rc_9c9cmvvp",
        "meeting_id": "mt_31tcke0x",
        "course_id": "cr_t6pv23df",
        "course": "Bordeaux Le Bouscat",
        "country": "FR",
        "date": "2026-10-20",
        "time": "09:20",
        "off_time": "09:20:42",
        "name": "Prix De Suffren Stakes",
        "race_type": "Flat",
        "class": null,
        "distance": "1m 1f 97y",
        "going": "Soft",
        "surface": "Turf",
        "handicap": false,
        "runners": 6,
        "result_available": true
      },
      "… 7 more"
    ]
  },
  "meta": {
    "plan": "results",
    "window": "2022-01-01 to now",
    "data_as_of": "2026-10-21T21:19:06Z"
  }
}

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_foundNo record has that id.
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.