**Version: 202601**

# List usage charges

**GET** `/openapi/2026-01/recurring_application_charges/:charge_id/usage_charge`

Retrieve all usage charges associated with a specific recurring application charge.

## Request

**Path Parameters**

- `charge_id` string (required)

  Charge ID

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `per_page` int32

  Number of usage charges to retrieve per page. Defaults to 20

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `usage_charges` object[]

    List of usage charges

    *   Array \[

    - `id` string

      Usage charge ID
    - `price` string

      Usage charge amount
    - `description` string

      Usage charge description
    - `balance_used` string

      Used balance
    - `balance_remaining` string

      Remaining balance
    - `created_at` string

      Creation time, in ISO-8601 format
    *   \]
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "usage_charges": [
      {
        "id": "string",
        "price": "string",
        "description": "string",
        "balance_used": "string",
        "balance_remaining": "string",
        "created_at": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```