# Get credits

> Get your account's total credits and settled usage in one currency, using a management key.

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

Source: https://0.0.0.0:3000/docs/api-reference/credits/get-credits
Authorization: Bearer management key

Name exactly one currency with `currency`, `USD` or `BTC`; balances are held per currency and never combined. `total_credits` minus `total_usage` is the account's balance in that currency, without holds for running requests. BTC amounts are in satoshis. A missing or unknown currency returns `400`. Per-key spending is available from [Get current key](/docs/api-reference/keys/get-current-key).

```request
{
  "method": "GET",
  "path": "/credits",
  "auth": "management",
  "query": { "currency": "USD" }
}
```

```json title="Response 200"
{
  "data": {
    "currency": "USD",
    "total_credits": 50,
    "total_usage": 12.75
  }
}
```

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

- `currency` (enum<string>; required; one of USD, BTC): Settlement currency to report. Required; there is no default currency.

## Response 200 (application/json)

- `data` (object; required)
  - `currency` (enum<string>; required; one of USD, BTC): The requested settlement currency; BTC values are Bitcoin base units.
  - `total_credits` (number; required): Net posted non-usage movements (funding less refunds, disputes, withdrawals, and corrections) as an exact decimal.
  - `total_usage` (number; required): Lifetime settled usage charges as an exact decimal.

## Response default (application/json)

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