Varmirdocs
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"