---
title: "Retrieve key status"
method: GET
path: "/v1/key"
---

# Retrieve key status

`GET /v1/key`

Returns usage information for the API key used to authenticate the request, including the organization's dev plan allowance and weekly premium-model usage. Lets clients that only hold an API key surface remaining quota without a dashboard session. Deliberately excludes billing details and the key token itself.

## Response `200`

Status of the API key and its organization's dev plan.

- object
  - `data` object, required
    - `label` string, required — Description of the API key used for the request.
    - `usage` string, required — Total usage in USD accrued by this API key.
    - `limit` string, nullable, required — Usage limit in USD set on this API key, if any.
    - `devPlan` 'none' | 'lite' | 'pro' | 'max', required — Dev plan tier of the organization this key belongs to. 'none' for pay-as-you-go organizations.
    - `devPlanCreditsUsed` string, required — Plan credits used in the current billing cycle, in USD.
    - `devPlanCreditsLimit` string, required — Plan credit allowance per billing cycle, in USD.
    - `devPlanCreditsRemaining` string, required — Plan credits remaining in the current billing cycle.
    - `devPlanPremiumWeeklyLimit` string, required — Weekly fair-use allowance for premium models, in USD of plan credits.
    - `devPlanPremiumCreditsUsed` string, required — Premium-model plan credits used in the current weekly window.
    - `devPlanPremiumWeekResetsAt` string, nullable, required — When the current premium weekly window resets (ISO 8601), or null when no window is active.

## Other responses

- `400` — Invalid request body or parameters.
- `401` — Missing or invalid API key.
- `402` — Insufficient credits or plan limits reached.
- `403` — Forbidden request or upstream response.
- `404` — Unknown model or upstream not-found response.
- `410` — Archived or unavailable project.
- `429` — Rate limited (organization, endpoint, or upstream provider). Back off until Retry-After elapses.
- `500` — Internal server error.
- `502` — Failed to connect to the upstream provider.
- `503` — Service unavailable upstream response.
- `504` — Upstream provider timeout.

---

[API](https://skmtc.dev/llmgateway/apis/llmgateway-api.md) · [All operations](https://skmtc.dev/llmgateway/apis/llmgateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/llmgateway/llmgateway-api/revisions/aaf167e3d8cc/schema)