Docs/API reference/GET /api/v1/usage
GET/api/v1/usage
Daily usage and a per-endpoint breakdown for the authenticated account.
Request
Optional days query param (1–90, default 30). Aggregates cover all keys of the account and are computed server-side per UTC day; days without traffic are omitted. Amounts are seconds of audio, the unit /transcribe charges in. Calls are free and limited to 30 per minute per key (429 rate_limited).
HTTP
GET https://api.varmir.com/api/v1/usage?days=30
Authorization: Bearer <YOUR_API_KEY>Response
requests counts successful charged requests; errors counts requests whose charge was refunded because no transcript could be produced.
{
"window_days": 30,
"from": "2026-10-07",
"total_sec": 1290,
"total_requests": 57,
"by_day": [
{ "date": "2026-11-04", "seconds": 840, "requests": 31, "errors": 1 },
{ "date": "2026-11-05", "seconds": 450, "requests": 26, "errors": 0 }
],
"by_endpoint": [
{ "endpoint": "/api/v1/transcribe", "seconds": 1290, "requests": 57 }
]
}Code examples
curl "https://api.varmir.com/api/v1/usage?days=30" \
-H "Authorization: Bearer mstk_your_key"