List usage charges

GET 
/openapi/2025-06/recurring_application_charges/:charge_id/usage_charge

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

Request

Path Parameters

charge_id stringrequired

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

Schema

codestring

error code

messagestring

error message

data object

usage_charges object[]

List of usage charges

Array [

idstring

Usage charge ID

pricestring

Usage charge amount

descriptionstring

Usage charge description

balance_usedstring

Used balance

balance_remainingstring

Remaining balance

created_atstring

Creation time, in ISO-8601 format

]

cursorstring

Cursor for pagination

has_moreboolean

Whether there are more records

Example

{
  "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
  }
}