# Credits

> Read your prepaid balance, spending limits and request history with the same key you send requests with.

Source: https://www.lyber.ai/docs/api/credits/ · Markdown: https://www.lyber.ai/docs/md/api/credits.md

Amounts are integers in micro-USDC: 1,000,000 equals $1 of credit. These endpoints are read-only; top up and change limits in the [dashboard](https://www.lyber.ai/dashboard/billing/).

## GET /v1/credits

Your balance. `available_micro_usdc` is what new requests can use: deposits and card credit, minus spending and open holds.

```bash
curl https://lyber-paid-acceptance-gateway-production.up.railway.app/v1/credits -H "Authorization: Bearer $LYBER_API_KEY"
```

```json
{
  "currency": "USDC",
  "decimals": 6,
  "available_micro_usdc": 9640000,
  "spent_micro_usdc": 310000,
  "reserved_micro_usdc": 50000,
  "deposited_micro_usdc": 0,
  "stripe_credit_micro": 10000000,
  "promotional_credit_micro": 0,
  "refunded_micro_usdc": 0
}
```

## GET /v1/credits/limits

This month's spending limits and committed spend (UTC month), for the account and for the key making the call. A `monthly_limit_micro` of `null` means no limit.

```json
{
  "currency": "USDC",
  "decimals": 6,
  "month_start": "2026-10-01T00:00:00+00:00",
  "account": {"monthly_limit_micro": 50000000, "committed_micro": 360000, "remaining_micro": 49640000},
  "key": {"key_id": "…", "monthly_limit_micro": null, "committed_micro": 120000, "remaining_micro": null}
}
```

## GET /v1/credits/requests

Your requests and their charges, newest first. `limit` sets the page size (1–100, default 50); pass `before` from the previous page to read further back.

## POST /v1/credits/reservation-preview

The credit hold a request would need, without sending it. The body is exactly `model` and `max_tokens`.

```bash
curl https://lyber-paid-acceptance-gateway-production.up.railway.app/v1/credits/reservation-preview \
  -H "Authorization: Bearer $LYBER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "minimax-m3.1-flash-abliterated", "max_tokens": 4096}'
```

The response includes `reservation_micro_usdc`, `available_micro_usdc`, `additional_credit_micro_usdc` (how much more you'd need) and `affordable`. A preview is not binding: prices and your balance can change before you send.