> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nozle.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Customer Credit Balances

> Read exact customer balances and source breakdowns

**Auth:** secret key only. Publishable keys are rejected.

List customer Credit System balances and their active or scheduled sources:

```http theme={null}
GET /customers/customer_123/credit-systems
Authorization: Bearer sk_nozle_...
```

Read one system:

```http theme={null}
GET /customers/customer_123/credit-systems/ai_credits/balance
Authorization: Bearer sk_nozle_...
```

```json theme={null}
{
  "customer_id": "customer_123",
  "credit_system": "ai_credits",
  "credit_system_name": "AI Credits",
  "unit_name": "credit",
  "available": "625.000000000000",
  "as_of": "2026-07-20T12:00:00.750Z",
  "sources": [
    {
      "type": "subscription_grant",
      "initial": "500.000000000000",
      "remaining": "375.000000000000",
      "expires_at": "2026-08-01T00:00:00Z",
      "available": true
    },
    {
      "type": "top_up",
      "initial": "250.000000000000",
      "remaining": "250.000000000000",
      "expires_at": null,
      "available": true
    }
  ]
}
```

Decimal amounts are strings. `available` includes only currently active, valid sources. The source list can also include scheduled sources whose `valid_from` is in the future; expired and exhausted sources are omitted.