Get current API key
/v1/keyChoose the scope and credential first
- One key's usage/budget: call
GET /v1/keywith that inference API key. Readusage,limit_remaining, andlimit_reset. This is a key spending budget, not the enterprise wallet or credit balance. - Enterprise wallet and credit: call
GET /enterprise/v1/billing/balancewith aMANAGEMENTkey scoped only totenant:billing:read. Inference and PROVISIONING keys cannot use it. - Account charges/request reconciliation: existing
GET /v1/billingandGET /v1/billing/requests/{request_id}use an inference key or signed-in JWT. Management keys cannot call these/v1endpoints. Recorded charges and remaining balance are different metrics. - Legacy account balance:
GET /v1/billing/balanceremains compatible and reports account funds, not the calling key's remaining budget. Prefer the Enterprise endpoint for new enterprise balance monitoring.
Enterprise API guide · Get enterprise balance
Get information about the API key used to authenticate the current request.
Authentication
Authorization Bearer
Use the inference API key being monitored in the Authorization header. Management/provisioning keys and JWT sessions are not accepted.
Response
dataobjectCurrent API key details.
data.hashstringHash identifier used by management endpoints.
data.namestringAPI key name.
data.labelstringHuman-readable label. Matches name.
data.disabledbooleanTrue when the key status is not ACTIVE or expires_at is in the past.
data.workspace_idstringWorkspace code for the key.
data.creator_user_idstring | nullOwner public UUID.
data.created_atstringCreate timestamp in UTC ISO-8601 format.
data.updated_atstring | nullLast update timestamp.
data.expires_atstring | nullUTC expiration timestamp, or null.
data.usagenumberTotal recorded spend for this key in USD.
data.usage_dailynumberUSD spend in the current UTC day.
data.usage_weeklynumberUSD spend in the current UTC week (Mon–Sun).
data.usage_monthlynumberUSD spend in the current UTC month.
data.limitnumber | nullConfigured USD spend limit, or null if unlimited.
data.limit_remainingnumber | nullRemaining USD budget in the current limit window, or null if unlimited.
data.limit_resetstring | nulldaily | weekly | monthly | null (lifetime).
data.is_free_tierbooleanCurrently false.
data.is_management_keybooleanFalse for the inference key accepted by this endpoint.
data.is_provisioning_keybooleanCurrently false.
data.rate_limitobjectPer-minute request limit metadata.