Documentation / Reference
Your usage
Free keyMCP tool: my_usage
Your calls today and this month, and your limits. Never counted against them.
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
https://api.horseracingapi.org/v1/usage
Press Run to see the live answer here.
curl "https://api.horseracingapi.org/v1/usage" \ -H "X-API-Key: hra_live_…"
Returns
FieldTypeWhat it holds
planstringfree or results.
plan_namestringFree key or Results plan.
windowstringWhat your plan reaches.
calls_todayintegerCalls since 00:00 UTC.
calls_monthintegerCalls since the 1st, UTC.
per_minuteintegerCalls allowed in any minute.
per_dayintegerCalls allowed a day, or null.
per_monthintegerCalls allowed a month, or null.
resetsobjectday and month: when each count starts again, UTC.
Example answer
{
"data": {
"plan": "free",
"plan_name": "Free key",
"window": "yesterday",
"calls_today": 0,
"calls_month": 0,
"per_minute": 10,
"per_day": 50,
"per_month": null,
"resets": {
"day": "2026-10-22T00:00:00Z",
"month": "2026-11-01T00:00:00Z"
}
},
"meta": {
"plan": "free",
"window": "yesterday",
"data_as_of": "2026-10-21T21:19:06Z"
}
}Errors
StatusCodeWhen