> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.resemble.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.resemble.ai/_mcp/server.

# Wallet

Use the wallet endpoints to inspect balances and activity and configure auto-reload.

```bash
export RESEMBLE_API_KEY="your_api_key"
export BILLING_API_BASE="https://app.resemble.ai/billing/api/v1"
```

## Read the wallet

```bash
curl "$BILLING_API_BASE/wallet" \
  -H "Authorization: Bearer $RESEMBLE_API_KEY"
```

The response separates cash and promotional balances and includes lifetime loaded and consumed amounts. Fields ending in `_cents` are authoritative monetary values; `_dollars` fields are included for display.

## List and export transactions

List a page of transactions:

```bash
curl "$BILLING_API_BASE/wallet/transactions?page=1&per_page=25" \
  -H "Authorization: Bearer $RESEMBLE_API_KEY"
```

`per_page` defaults to 10 and is capped at 100. Alternatively, `limit` returns only that many recent transactions and omits pagination metadata:

```bash
curl "$BILLING_API_BASE/wallet/transactions?limit=5" \
  -H "Authorization: Bearer $RESEMBLE_API_KEY"
```

Export the complete transaction history as CSV:

```bash
curl "$BILLING_API_BASE/wallet/transactions/export.csv" \
  -H "Authorization: Bearer $RESEMBLE_API_KEY" \
  --output wallet-transactions.csv
```

## Configure auto-reload

Read the current setting and supported reload range before updating it:

```bash
curl "$BILLING_API_BASE/wallet/auto_reload" \
  -H "Authorization: Bearer $RESEMBLE_API_KEY"
```

The response reports whether a payment method is present and whether the wallet can currently reload. Add or change payment methods in the Resemble dashboard.

Enable or update auto-reload using cent-denominated amounts:

```bash
curl --request PUT "$BILLING_API_BASE/wallet/auto_reload" \
  -H "Authorization: Bearer $RESEMBLE_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
    "enabled": true,
    "reload_amount_cents": 5000,
    "minimum_balance_threshold_cents": 1000,
    "maximum_monthly_spend_cents": 20000
  }'
```

Use the minimum and maximum returned by `GET /wallet/auto_reload` rather than hard-coding platform limits.

To disable auto-reload, send the complete settings payload with `enabled: false`.

## API reference

* [Get the billing wallet](/api-reference/billing-wallet/get-billing-wallet)
* [List wallet transactions](/api-reference/billing-wallet/list-billing-wallet-transactions)
* [Get auto-reload settings](/api-reference/billing-wallet/get-billing-auto-reload)