Your usage

Documentation / Reference

Free keyRace PassArchive PassMCP tool my_usage

Your plan, calls today and limits. Free to call. Covers the UK, Ireland and Australia.

GEThttps://api.greyhoundracingapi.com/v1/usage

Try it

Your key

No key yet? The free key is made in a moment and filled in here for you. Get a free key

GET https://api.greyhoundracingapi.com/v1/usage

Run works once the API is live; the code below works now with the login.

Parameters

None.

Returns

Field	Type	What it holds
`plan`	string	Your plan.
`key`	string	The start of the key you called with.
`calls_today`	integer	Calls today across all your keys, UTC.
`calls_this_month`	integer	Calls this calendar month.
`per_day`	integer	Your daily allowance.
`per_minute`	integer	Calls allowed per minute.
`resets_at`	datetime	When the daily count resets, UTC.
`window`	string	`yesterday`, `live` or `archive`.
`countries`	array	Countries your plan covers.

Example answer

A real answer from 6 October 2026, 13:10 UTC.

{
    "data": {
        "plan": "Archive Pass",
        "key": "gra_live_xxxx",
        "calls_today": 55,
        "calls_this_month": 55,
        "per_day": 50000,
        "per_minute": 240,
        "resets_at": "2026-10-07T00:00:00Z",
        "window": "archive",
        "countries": [
            "GB",
            "IE",
            "AU"
        ]
    },
    "meta": {
        "count": 1,
        "took_ms": 232
    }
}

Errors

Status	Code	What to do
401	`unauthorized`	No key, or the key is wrong, revoked or expired. Check the header.
422	`unknown_parameter`	A parameter this endpoint does not take. The message lists the ones it does.
429	`rate_limited`	Too many calls this minute. Wait for `Retry-After`.
429	`quota_exceeded`	Today's allowance is used. It resets at 00:00 UTC.
503	`server_error`	Our side. Not counted against you. Try again shortly, and see status.