Docs/API reference/GET /api/v1/me
GET
/api/v1/me
Returns the authenticated user, key info, credit balance and plan quota.Free · 30 requests/min per keyAuthentication required
Request
A single authenticated GET. No body, no query parameters — just your key in the Authorization header. Calls to /me are free: they never touch your quota or credits. Each key may call it up to 30 times per minute; beyond that you get 429 rate_limited.
HTTP
GET https://api.varmir.com/api/v1/me
Authorization: Bearer <YOUR_API_KEY>Response
Returns a JSON object with four keys: user, key, credits and quota. All amounts are in seconds of audio, the same unit /transcribe charges in.
{
"user": {
"id": "usr_91",
"email": "[email protected]",
"name": "Oleksandr"
},
"key": {
"id": "key_8f3a",
"name": "Production",
"prefix": "mstk_lfQZYRA"
},
"credits": {
"balance": 982,
"lifetime_purchased": 1000,
"balance_sec": 58920,
"lifetime_sec": 60000
},
"quota": {
"plan": "pro",
"limit_sec": 480000,
"remaining_sec": 431250,
"resets_at": "2026-12-01T09:00:00+00:00"
}
}Response fields
FieldTypeDescription
user.idstringStable user identifier.
user.emailstringAccount email.
user.namestring | nullDisplay name, may be null.
key.idstringIdentifier of the API key that authenticated the request.
key.namestringName you gave the key in the dashboard.
key.prefixstringFirst characters of the key, safe to log.
credits.balance_secintegerPurchased seconds left. Used only after the plan quota runs out.
credits.lifetime_secintegerTotal seconds ever purchased on the account.
credits.balanceintegerLegacy: balance_sec in whole minutes. Prefer balance_sec.
credits.lifetime_purchasedintegerLegacy: lifetime_sec in whole minutes. Prefer lifetime_sec.
quota.planstringCurrent plan: free, pro, business or enterprise.
quota.limit_secinteger | nullSeconds included per billing period; 0 means unlimited.
quota.remaining_secinteger | nullSeconds of plan quota left this period; null when unlimited.
quota.resets_atstringISO 8601 time when the quota period ends and resets.
Code examples
Read your remaining quota and credits in your language of choice.
curl https://api.varmir.com/api/v1/me \
-H "Authorization: Bearer mstk_your_key"