Get Usage Stats
Returns request counts for your key against your plan allowance, and how many of them came through the hosted MCP server against its lower daily limit. Defaults to the current billing month; pass days for a trailing window instead.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- string
Billing month to report on, formatted YYYY-MM
- Example
- integer
Trailing window in days, as an alternative to month
- Example
- object
The response payload.
- object
Totals for the reported period, meaning the current billing month, or the trailing window when
daysis given. - integer
Requests counted in the reported period across every key on the account.
- integer
Requests your plan allows in the period.
- number
Share of records, 0 to 100.
- string
When the counter next returns to zero, ISO 8601 UTC.
- object
Usage through the hosted MCP server, a subset of the requests above.
- integer
Calls made through the MCP server in the reported month. Already counted in
currentMonth.used, never on top of it. - integer
MCP calls today (UTC) across every key on the account.
- integer
MCP calls one key may make per UTC day on this plan. The limit applies to each key separately.
- object | null
The key nearest its daily MCP limit, or null when no key has made an MCP call today.
- string
When the daily MCP counters return to zero: the next midnight UTC.
- object[]
Requests per day over the reported period, oldest first. Days with no traffic are omitted.
- string
The day,
YYYY-MM-DDin UTC. - integer
How many records fall in this bucket.
- integer
Of
count, the requests made through the MCP server. - object[]
Requests per API key over the reported period.
- string
Id of the API key. The key itself is never returned.
- string
The label you gave the key.
- integer
How many records fall in this bucket.
- integer
Of
count, the requests made through the MCP server. - integer
MCP calls this key made today (UTC), the figure its daily MCP limit is held against.
- integer
How many API keys the account holds.
- object
The allowances of the plan the account is on.
- string
Display name, as the maker writes it.
- integer
Monthly request allowance on this plan.
- integer
Requests per minute this plan allows.
- integer
MCP calls each key may make per UTC day on this plan.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
Usage counters reset at the start of each billing period.
The requests_limit reflects your current subscription plan allowance.
The breakdown object only includes HTTP methods that have been used at least once.
For real-time rate limit status (requests per minute), check the X-RateLimit-Remaining response header on any API call.
- Minimum tier
- Explorer+
- Monthly quota
- 200/mo
- Rate limit
- 10/min
- Daily cap
- 50
Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.