# wallets

> Prepaid wallets, ledger, top-ups, auto top-up and low-balance alerts.

Prepaid wallets, ledger, top-ups, auto top-up and low-balance alerts.

| Method | Path | Operation | Scope | Test mode |
|---|---|---|---|---|
| GET | `/v1/billing/wallets` | `wallets_list`: Wallets: AI credits and Call Balance | `billing:read` | - |
| GET | `/v1/billing/wallets/{wallet_id}` | `wallets_get`: One wallet | `billing:read` | - |
| PUT | `/v1/billing/wallets/{wallet_id}/alerts` | `wallets_alerts_set`: Low-balance thresholds | `billing:write` | - |
| PUT | `/v1/billing/wallets/{wallet_id}/auto-topup` | `wallets_auto_topup_set`: Auto top-up rule and monthly cap | `billing:write` | - |
| POST | `/v1/billing/wallets/{wallet_id}/topup` | `wallets_topup`: Top up a wallet (AI credits or Call Balance) | `billing:write` | - |
| GET | `/v1/billing/wallets/{wallet_id}/transactions` | `wallets_transactions_list`: Ledger | `billing:read` | - |
| GET | `/v1/billing/wallets/topup-quote` | `wallets_topup_quote`: Price a wallet top-up before paying | `billing:read` | - |

Request and response schemas: the interactive reference at `https://api.wapitick.com/docs`, or `docs/api/openapi.json`.
