# List Charges

List charges with cursor-based pagination.

Filters:
- customer_id: Filter by customer UUID
- instrument_id: Filter by instrument UUID
- reference: Filter by exact reference match
- created_at_from: Filter charges created on or after this date
- created_at_to: Filter charges created on or before this date
- result_at_from: Filter charges with result on or after this date
- result_at_to: Filter charges with result on or before this date
- instrument_identifier: Filter by instrument identifier (inline or linked)

Pagination:
- cursor: Opaque cursor from previous response
- Use next_cursor from response for next page

Endpoint: GET /charges
Version: 0.1.0

## Query parameters:

  - `limit` (integer)
    Maximum number of records to return

  - `cursor` (any)
    Cursor for pagination (use next_cursor from previous response)

  - `customer_id` (any)
    Filter by customer ID

  - `instrument_id` (any)
    Filter by instrument ID

  - `reference` (any)
    Filter by reference

  - `created_at_from` (any)
    Filter charges created on or after this date

  - `created_at_to` (any)
    Filter charges created on or before this date

  - `result_at_from` (any)
    Filter charges with result on or after this date

  - `result_at_to` (any)
    Filter charges with result on or before this date

  - `instrument_identifier` (any)
    Filter by instrument identifier (searches both inline and linked instruments)

## Header parameters:

  - `X-API-Key` (any)

## Response 200 fields (application/json):

  - `charges` (array, required)

  - `charges.org_id` (string, required)
    ID of the organization

  - `charges.instrument_id` (any)
    ID of the payment instrument

  - `charges.customer_id` (any)
    ID of the customer

  - `charges.amount` (number, required)
    Charge amount

  - `charges.currency` (any)
    Currency code

  - `charges.reference` (any)
    Reference provided by tenant

  - `charges.inline_instrument` (any)
    Inline instrument data

  - `charges.inline_customer` (any)
    Inline customer data

  - `charges.id` (string, required)

  - `charges.status` (string, required)
    Charge status enum.
    Enum: "verification_in_progress", "pending", "processing", "confirmed", "declined", "chargeback", "canceled"

  - `charges.declined_reason` (any)

  - `charges.declined_reason_rail` (any)

  - `charges.created_at` (string, required)

  - `charges.updated_at` (any)

  - `charges.chargeback_at` (any)

  - `charges.result_at` (any)

  - `charges.risk_status` (any)

  - `charges.risk_evaluated_at` (any)

  - `charges.risk_reasons` (any)

  - `limit` (integer, required)

  - `has_next` (boolean)

  - `has_previous` (boolean)

  - `next_cursor` (any)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)