List Charges

Retrieve a paginated list of charges created within a time window. Results are filtered by a mandatory creation-time range and can be further narrowed by status and source account. Use the returned cursors to page through large result sets.
Request Parameters
fromCreatedAtdatetime
required
Start of the creation-time window (inclusive), following the ISO 8601 standard. See Data Types. Must be earlier than toCreatedAt, and the window span must not exceed 31 days.
toCreatedAtdatetime
required
End of the creation-time window (exclusive), following the ISO 8601 standard. See Data Types. Must be later than fromCreatedAt, and the window span must not exceed 31 days.
statusstring
Filter by charge status. If omitted, charges of all statuses are returned.

Valid Values:

PROCESSING — The charge is being processed asynchronously.
SUCCESS — The charge was deducted successfully (terminal).
FAILED — The charge could not be completed (terminal).
sourceAccountIdstring
Filter by the merchant account that was debited. If omitted, charges across all accessible accounts are returned.
limitinteger
Maximum number of charges to return per page. If omitted, the platform default page size applies.
cursorstring
Pagination cursor. Pass the nextCursor or prevCursor from a previous response to fetch the adjacent page. Omit to fetch the first page.
Response Parameters
resultResult
See Result.
itemsarray
List of charges matching the filters, ordered by creation time.
Show child parametersShow child parameters
nextCursorstring
Cursor for the next page. Pass it as cursor on the following request. Absent when there are no more pages.
prevCursorstring
Cursor for the previous page. Pass it as cursor to page backward. Absent when on the first page.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
PARAM_ILLEGALFIllegal parameters. Refer to the API documentation to verify the request parameters, then retry.Ensure `fromCreatedAt` is earlier than `toCreatedAt` and the window span does not exceed 31 days.
Definition
POST /api/open/v1/charges/list
Request
{
"fromCreatedAt": "2026-08-01T00:00:00+08:00",
"toCreatedAt": "2026-08-08T00:00:00+08:00",
"status": "SUCCESS",
"sourceAccountId": "20260101000000067890",
"limit": 20
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultStatus": "S",
  "resultMessage": "success"
},
"items": [
  {
    "id": "20260808000000098765",
    "requestId": "req_c1h2a3r4",
    "sourceAccountId": "20260101000000067890",
    "chargeAmount": {
      "currency": "USD",
      "value": 1000
    },
    "chargeCategory": "PLATFORM_FEE",
    "status": "SUCCESS",
    "referenceOrderId": "order_20260808001",
    "transferMemo": "August platform service fee",
    "feeAmount": {
      "currency": "USD",
      "value": 6
    },
    "feeRate": "0.006",
    "createdAt": "2026-08-08T08:00:00+08:00",
    "updatedAt": "2026-08-08T08:00:05+08:00",
    "completedAt": "2026-08-08T08:00:05+08:00"
  }
],
"nextCursor": "eyJvZmZzZXQiOjIwfQ=="
}