# Get current key

> Inspect the key making the request — its limit, remaining budget, usage windows and expiry.

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

Source: https://0.0.0.0:3000/docs/api-reference/keys/get-current-key
Authorization: Bearer inference key

Works with an inference key or a management key. Money values are in the key's billing currency (omitted for management keys) and are written from exact decimals. `limit_remaining` is floored at zero and uses the window selected by `limit_reset`. Guide: [API keys](/docs/account/api-keys).

```request
{
  "method": "GET",
  "path": "/key"
}
```

```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,
    "is_management_key": false
  }
}
```

## 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.

## Response 200 (application/json)

- `data` (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)
  - `is_management_key` (boolean; required)

## Response default (application/json)

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