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

# Check your wallet

> Read your API wallet balance — deposit, free credit, and how many scans you can still run.

Check how much is in your API wallet before submitting scans — useful from a script or an agent so you never get surprised by a `402 insufficient_balance`. Read-only: it never debits.

```bash theme={null}
curl https://www.thesapientcompany.com/api/v1/wallet \
  -H "Authorization: Bearer sk_live_YOUR_KEY_HERE"
```

## Response

```json theme={null}
{
  "object": "wallet",
  "currency": "usd",
  "deposit_balance_usd": 40.00,
  "free_credit_remaining_usd": 2.50,
  "free_credit_monthly_usd": 2.50,
  "free_credit_period_start": "2026-06-01",
  "total_available_usd": 42.50,
  "price_per_scan_usd": { "qualia": 2.50 },
  "scans_remaining_estimate": 17
}
```

| Field                       | Meaning                                                                                            |
| --------------------------- | -------------------------------------------------------------------------------------------------- |
| `deposit_balance_usd`       | Your prepaid deposit remaining. Top up in **Settings → API**.                                      |
| `free_credit_remaining_usd` | This month's free credit left (the first **\$2.50** of usage each month is free).                  |
| `free_credit_monthly_usd`   | The monthly free allowance, reset on the 1st (UTC).                                                |
| `free_credit_period_start`  | First day of the current free-credit month (UTC).                                                  |
| `total_available_usd`       | `deposit_balance_usd` + `free_credit_remaining_usd` — what you can actually spend now.             |
| `price_per_scan_usd`        | Current per-scan price by model (Qualia is the default and only available model).                  |
| `scans_remaining_estimate`  | `total_available_usd` ÷ the Qualia price, rounded down — roughly how many scans you can still run. |

A debit is settled the first time you fetch a completed scan, so `total_available_usd` reflects everything charged up to now.

## Errors

| Status | `error`              | When                                  |
| ------ | -------------------- | ------------------------------------- |
| `401`  | `unauthorized`       | Missing, invalid, or revoked API key. |
| `405`  | `method_not_allowed` | Use `GET`.                            |

See [Errors](/api-reference/errors) for the full list.