Get usage
Returns the request allowance left before the API starts answering 429.
HTTP request
GET https://www.asqiro.com/api/v1/usage
Any API key in the survey's workspace.
Response body
| Field | Type | Description |
|---|---|---|
| burstLimit | integer | Requests allowed inside the short burst window. |
| burstWindowMinutes | integer | Length of the burst window, in minutes. |
| dailyLimit | integer | Requests allowed per day. |
| usedToday | integer | Requests already spent in the current day. |
| remainingToday | integer | Requests left before the daily limit is reached. |
| monthlyLimit | integer | Requests allowed per calendar month. |
| resetAt | string (ISO 8601) | When the daily counter resets. |
Note Every key an account created draws on one shared quota, so this returns the same numbers whichever of that account's keys asks for them.
Note This call is itself a request and counts against the quota it reports. Poll it on a schedule rather than before every call.
Errors
- unauthorized · 401 · The API key is missing, malformed, deleted, or its creator lost workspace access. Check the Authorization header, then the key itself.
- plan_upgrade_required · 403 · The workspace owner's plan does not include API access. Upgrading the plan restores it; retrying will not.
- rate_limited · 429 · Too many requests. The Retry-After response header carries the number of seconds to wait.
- service_unavailable · 503 · The request was valid but could not be completed safely right now. No data was returned or changed, so the same request can be retried.
Example request
bash
curl "https://www.asqiro.com/api/v1/usage" \
-H "Authorization: Bearer $ASQIRO_API_KEY"Returns 200 on success.
json
{
"burstLimit": 600,
"burstWindowMinutes": 5,
"dailyLimit": 50000,
"usedToday": 1250,
"remainingToday": 48750,
"monthlyLimit": 500000,
"resetAt": "2026-09-10T00:00:00.000Z"
}