Usage API
Read usage and remaining budget for an Arcflow key.
GET /v1/usage returns the budget for the sk-...* key used to
authenticate the request.
curl https://api.tryarcflow.com/v1/usage \
-H "Authorization: Bearer $ARCFLOW_API_KEY"Response
{
"object": "api_key.usage",
"id": "key_abc",
"name": "Claude Prod",
"redacted_value": "sk-...abcd",
"created_at": 1711471533,
"last_used_at": 1711555126,
"foundation": "all",
"budget": {
"used_percent": 40,
"remaining_percent": 60
},
"subscription": {
"product_id": "prod_pro",
"five_hour": { "window_seconds": 18000, "used_percent": 30, "remaining_percent": 70 },
"weekly": { "window_seconds": 604800, "used_percent": 42, "remaining_percent": 58 }
}
}Budget consumption is reported as percentages only — the underlying USD
limit and spend are intentionally withheld from this public, key-authenticated
endpoint. The subscription block is present only for keys on a subscription
tier and reports rolling 5-hour and weekly windows.
Interactive page
The public /en/usage page calls this endpoint from the browser.
It does not store the key and does not pass through a Next.js backend route.
Budget schema
| Field | Type | Description |
|---|---|---|
used_percent | number | Percentage of the key's budget consumed. |
remaining_percent | number | Percentage of the key's budget remaining. |