---
title: "List charges"
method: GET
path: "/charges"
tags: ["Charges"]
---

# List charges

`GET /charges`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/charges`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-api-reference/docs/charges/get.ts> (a function with typed inputs; its response is checked against the schema)

Return a paginated list of charges.

## Query parameters

- `limit` integer
- `page` string
- `search` string
- `order` string
- `starting_at` string, date-time
- `ending_at` string, date-time

## Response `200`

A paginated list of charges.

- ChargeListResponse
  - `count` integer
  - `limit` integer
  - `page` integer
  - `results` Charge[]
    - `id` string: Unique identifier for the charge.
    - `amount` number, double: Authorized amount of the charge in USD.
    - `customer_id` string: Unique identifier of the customer.
    - `amount_refunded` number, double: Total refunded amount for the charge in USD.
    - `canceled` boolean: Indicates whether the charge is canceled.
    - `canceled_at` string, date-time: Date the charge was canceled.
    - `captured` boolean: Indicates whether the charge has been captured.
    - `captured_at` string, date-time: Date the charge was captured.
    - `created_at` string, date-time: Date the charge was created.
    - `invoice_url` string, uri: URL of the invoice document associated with this charge.
    - `metadata` object: Custom metadata attached to the charge.
    - `number` string: Charge number identifier.
    - `terms` 'due_upon_receipt' | 'net7' | 'net10' | 'net10th' | 'net15' | 'net20' | 'net30' | 'net45' | 'net60' | 'net75' | 'net90' | 'net120' | 'net180': Payment terms associated with the charge.
    - `updated_at` string, date-time: Date the charge was last updated.
    - `merchant_invoice_id` string: ID of the merchant invoice associated with the charge.
    - `order_number` string: Order number associated with the charge.
    - `po_number` string: PO number associated with the charge.
    - `fee` number, double: Fee amount associated with the charge in USD.
    - `fee_refunded` number, double: Refunded fee amount for the charge in USD.

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-api-reference/revisions/c62edc454aaa?raw)