# List keys

> List the account's inference keys with a management key, 100 per page.

`GET https://api.numes.ai/api/v1/keys`

Source: https://0.0.0.0:3000/docs/api-reference/keys/list-keys
Authorization: Bearer management key

Returns inference keys only. Page with `offset`; add `include_disabled=true` to include disabled keys. A management key sees the keys its creator may manage: organization members see keys they created, owners and administrators see all. Guide: [Management keys](/docs/account/management-keys).

```request
{
  "method": "GET",
  "path": "/keys",
  "auth": "management",
  "query": { "include_disabled": "false", "offset": "0" }
}
```

```json title="Response 200"
{
  "data": [
    {
      "hash": "5d41402abc4b2a76b9719d911017c592ae2f5e8f5d9c4b1e0a3f6e7d8c9b0a1f",
      "label": "sk-...-v1-3f9a...c21e",
      "name": "Production backend",
      "billing_currency": "USD",
      "disabled": false,
      "limit": 25,
      "limit_remaining": 18.42,
      "limit_reset": "monthly",
      "usage": 6.58,
      "usage_daily": 0.31,
      "usage_weekly": 2.07,
      "usage_monthly": 6.58,
      "created_at": "2026-09-01T09:30:00Z",
      "updated_at": null,
      "expires_at": null
    }
  ]
}
```

## Headers

- `X-Request-Id` (string; Length 1–128): Correlation ID, not an idempotency key. Inference request IDs recorded with a generation are unique per account. A traffic-admitted request reusing a recorded ID returns 400 invalid_request. Traffic admission rejection takes precedence over this conflict, including for reused IDs; it performs no generation lookup and writes no generation, result or attempt. Rate-limit rejection returns 429 rate_limited with Retry-After; an inference limiter outage retains 500 server.

## Query parameters

- `include_disabled` (boolean; default false)
- `offset` (integer; default 0; Range ≥ 0)

## Response 200 (application/json)

- `data` (array<object>; required)
  - `hash` (string; required)
  - `label` (string; required)
  - `name` (string; required)
  - `billing_currency` (enum<string>; one of USD, BTC): Immutable settlement currency; omitted for management keys.
  - `disabled` (boolean; required)
  - `limit` (number | null; required)
  - `limit_remaining` (number | null; required)
  - `limit_reset` (enum<string> | null; required; one of daily, weekly, monthly)
  - `usage` (number; required)
  - `usage_daily` (number; required)
  - `usage_weekly` (number; required)
  - `usage_monthly` (number; required)
  - `created_at` (string<date-time>; required)
  - `updated_at` (string<date-time> | null; required)
  - `expires_at` (string<date-time> | null; required)

## Response default (application/json)

- `error` (object; required)
  - `code` (integer; required)
  - `message` (string; required)
  - `metadata` (object)
- `openrouter_metadata` (object)