GET /v1/limits


Call	`GET /v1/limits`
Price	free
Scope	`account:read`
Operation id	`getLimits`

What it does

The rate limit, spend cap and request size limits that apply to the calling key, and the starter allowance left. Call it before batching. Free. Scope: account:read.

Example request

Copy it as curl. Set VERDICT_API_KEY first; uuidgen makes a fresh Idempotency-Key.

curl -X GET 'https://api.askverdict.io/v1/limits' \
  -H "Authorization: Bearer $VERDICT_API_KEY"

Example response

200: The limits.

{
  "rate_limit": {
    "requests_per_minute": 600,
    "burst": 100
  },
  "daily_spend_cap_usd": 25,
  "spent_today_usd": 1.42,
  "request_limits": {
    "max_body_bytes": 262144,
    "max_roster_entries": 50,
    "max_thread_messages": 40,
    "max_message_bytes": 8192,
    "max_page_limit": 200
  },
  "starter": {
    "card_required": false,
    "free_usd_remaining": 3.58,
    "free_calls_remaining": 716
  }
}

Parameters

Name	In	Type	Required	Description
`x-verdict-version`	header	string	no	API version to use, a date. Defaults to the version current when the key was created. The current version is `2026-11-01`.

Response fields (200)

Schema LimitsResponse.

Field	Type	Required	Description
`rate_limit`	object	yes	Rate limit of the calling key.
`rate_limit.requests_per_minute`	integer	yes	Requests per minute for this key.
`rate_limit.burst`	integer	yes	Burst allowance.
`daily_spend_cap_usd`	number or null	yes	Daily spend cap of the key, or `null`. US dollars, up to 6 decimals.
`spent_today_usd`	number	yes	Spent today (UTC) by the key. US dollars, up to 6 decimals.
`request_limits`	object	yes	Request size limits (spec 9.4).
`request_limits.max_body_bytes`	integer	yes	Maximum request body size.
`request_limits.max_roster_entries`	integer	yes	Maximum `pick_person` roster size.
`request_limits.max_thread_messages`	integer	yes	Maximum `triage_reply` thread length.
`request_limits.max_message_bytes`	integer	yes	Maximum bytes per message.
`request_limits.max_page_limit`	integer	yes	Maximum `limit` on list endpoints.
`starter`	object	yes	Starter allowance (spec 9.1): a card is required past $5 or 1,000 calls.
`starter.card_required`	boolean	yes	Whether a card is now required to keep calling.
`starter.free_usd_remaining`	number	yes	Starter credit left before a card is required. US dollars, up to 6 decimals.
`starter.free_calls_remaining`	integer	yes	Calls left before a card is required.

Errors

Errors are RFC 9457 problem details and are never billed. Branch on type. See Errors.

Status	Meaning
`400`	Invalid request: malformed JSON, an unknown field, a failed constraint or a size limit (`invalid_request`).
`401`	Missing, malformed, revoked or expired API key, or a bad webhook signature (`unauthorized`).
`403`	The key lacks the scope this operation needs (`forbidden_scope`).
`429`	Rate limited (`rate_limited`). Wait `Retry-After` seconds.
`500`	Unexpected server error (`internal`). Not billed; retry with the same `Idempotency-Key`.

Try it

Open the interactive reference to send this request from the browser. The full document is at /openapi.json.