Your usage

Every plan, free key included

Your plan, window and calls used.

GEThttps://api.horseracingapi.co.uk/v1/usage

Try itruns against the real API with your key

Your key, kept in this browser

GET /v1/usage

Examplea real answer from 2026-10-29

{
    "data": {
        "plan": "complete",
        "plan_name": "Complete",
        "window": {
            "from": "2017-01-01",
            "to": "2026-11-02",
            "words": "January 2017 to the next 3 days"
        },
        "calls_today": 214,
        "calls_this_month": 18410,
        "per_minute": 180,
        "per_month": 400000,
        "resets": "2026-11-01",
        "house_key": false
    },
    "meta": {
        "request_id": "ff8b7aad6fe5ff6a",
        "plan": "complete",
        "window": "January 2017 to the next 3 days"
    }
}

Parameters

None. Send your key and nothing else.

Returns

One record in data. Every answer carries meta: request_id, plan, window and data_as_of.

Field	Type	Holds
`plan`	string	The plan your key is on.
`plan_name`	string	The plan's name.
`window`	object	The days your plan reads.
`window.from`	string
`window.to`	string
`window.words`	string
`calls_today`	integer	Calls made today, UTC.
`calls_this_month`	integer	Calls made this month, UTC.
`per_minute`	integer	Calls allowed a minute.
`per_month`	integer	Calls allowed a month.
`resets`	string	When the monthly count starts again.
`house_key`	boolean	True for a house key.

Errors

Code	Status	When
`unauthorized`	401	No key was sent, or the key is not one of ours.
`unknown_parameter`	422	A parameter this endpoint does not take. The answer lists the ones it does.
`rate_limited`	429	Too many calls this minute for your plan.
`quota_exceeded`	429	Your plan's calls for the month are used. The answer says when they reset.

PreviousGET /v1/owners/{owner_id}/jockeys NextMCP server