List charges
recharge_list_chargesRead-only
List charges with optional filters (customer, address, status, ids, purchase item, scheduled/created/updated date ranges) and sorting. Returns { charges }. Pagination is cursor-based: pass limit (default 50, max 250) and read next_cursor / previous_cursor from the response. IMPORTANT: when paging with cursor, Recharge accepts ONLY limit alongside it — omit every other filter on cursor requests. Recharge REST: GET /charges.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | Comma-separated list of charge ids to fetch. | |
| limit | No | Max results per page (1-250, default 50). | |
| cursor | No | Pagination cursor (next_cursor / previous_cursor from a prior response). Use it ALONE with `limit` — omit all other filters on cursor requests. | |
| status | No | Filter by charge status: success | queued | error | refunded | partially_refunded | skipped | pending_manual_payment | pending. | |
| sort_by | No | Sort order: id-asc | id-desc | updated_at-asc | updated_at-desc | scheduled_at-asc | scheduled_at-desc. | |
| address_id | No | Filter by address id. | |
| customer_id | No | Filter by customer id. | |
| scheduled_at | No | Filter to charges scheduled on this date (ISO 8601). | |
| created_at_max | No | Filter to charges created on/before this date (ISO 8601). | |
| created_at_min | No | Filter to charges created on/after this date (ISO 8601). | |
| updated_at_max | No | Filter to charges updated on/before this date (ISO 8601). | |
| updated_at_min | No | Filter to charges updated on/after this date (ISO 8601). | |
| purchase_item_id | No | Filter to charges containing this purchase item (subscription/onetime line item) id. | |
| scheduled_at_max | No | Filter to charges scheduled on/before this date (ISO 8601). | |
| scheduled_at_min | No | Filter to charges scheduled on/after this date (ISO 8601). |