List Statements

Query reconciliation statements with pagination and filters. Supports filtering by transaction type, currency, balance type, and date range.
Request Parameters
limitinteger
Number of records per page. Range: 1–100. Default: 20.
cursorstring
Pagination cursor token from the previous response's nextCursor or prevCursor. Omit for the first page.
fromTransactAtdatetime
required
Start of the transaction time range (inclusive). Use together with toTransactAt. Maximum time span: 100 days, following the ISO 8601 standard. See Data Types.
toTransactAtdatetime
required
End of the transaction time range (exclusive). Use together with fromTransactAt, following the ISO 8601 standard. See Data Types.
transactionTypesarray
Filter by transaction types (OR logic). Omit to return all types. See TransactionType.
currenciesarray
Filter by currency codes, following the ISO 4217 standard. See Data Types. Omit to return all currencies.
balanceTypesarray
Filter by balance type. Omit to default to NORMAL_BALANCE.

Valid Values:

NORMAL_BALANCE — Standard e-commerce balance (default).
SAME_NAME_TOP_UP_BALANCE — Same-name top-up balance.
BUDGET_BALANCE — Budget account balance. Use with budgetAccountIds.
budgetAccountIdsarray
List of budget account IDs. Required when balanceTypes includes BUDGET_BALANCE.
keywordString conditional
Keyword for exact-match search, matched against either transactionId or externalTransactionId. When provided, this parameter takes precedence over the transaction date range filter, which is then ignored.
Response Parameters
resultResult
See Result.
itemsarray
Array of statement records. In list responses, fundFlowDetail returns only payer and beneficiary names, and combinedTransactions is not included. Use Query a Statement to get full details.
Show child parametersShow child parameters
nextCursorstring
Cursor for the next page. Returned when more results exist.
prevCursorstring
Cursor for the previous page. Null on the first page.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSSuccessN/A
CURRENCY_NOT_SUPPORTEDFThe currency is not supported.Remove unsupported currency codes from `currencies`.
ACCESS_TOKEN_EXPIREDFThe access token expired.Refresh the OAuth access token and retry.
Definition
POST /api/open/v1/statements/list
Request
{
"limit": 20,
"fromTransactAt": "2026-04-01T00:00:00+08:00",
"toTransactAt": "2026-04-23T23:59:59+08:00",
"transactionTypes": [
  "TRANSFER",
  "COLLECTION"
],
"currencies": [
  "USD",
  "GBP"
],
"balanceTypes": [
  "NORMAL_BALANCE"
]
}
Response
{
"result": {
  "resultStatus": "S",
  "resultCode": "SUCCESS",
  "resultMessage": "success"
},
"items": [
  {
    "id": "STM202604200000****",
    "transactionId": "TXN20260420xxxxx",
    "transactionType": "COLLECTION",
    "status": "SUCCESS",
    "transactionAmount": {
      "value": 1500000,
      "currency": "USD"
    },
    "originalTransactionAmount": {
      "value": 1500000,
      "currency": "USD"
    },
    "balanceAmount": {
      "value": 5230050,
      "currency": "USD"
    },
    "balanceType": "NORMAL_BALANCE",
    "fundFlowDetail": {
      "payerInfo": {
        "name": "Acme Corp ****"
      },
      "beneficiaryInfo": {
        "name": "Global Trade Inc."
      }
    },
    "transactedAt": "2026-04-20T14:30:00+08:00"
  },
  {
    "id": "STM202604180000****",
    "transactionId": "TXN20260418xxxxx",
    "transactionType": "TRANSFER",
    "status": "SUCCESS",
    "transactionAmount": {
      "value": -250000,
      "currency": "GBP"
    },
    "originalTransactionAmount": {
      "value": 260000,
      "currency": "GBP"
    },
    "feeAmount": {
      "value": 10000,
      "currency": "GBP"
    },
    "netAmount": {
      "value": 250000,
      "currency": "GBP"
    },
    "balanceAmount": {
      "value": 1820030,
      "currency": "GBP"
    },
    "balanceType": "NORMAL_BALANCE",
    "exchangeRate": {
      "sellCurrency": "GBP",
      "buyCurrency": "CNY",
      "rate": "8.5000"
    },
    "fundFlowDetail": {
      "payerInfo": {
        "name": "Acme Corp ****"
      },
      "beneficiaryInfo": {
        "name": "Global Trade Inc."
      }
    },
    "transactedAt": "2026-04-18T09:15:00+08:00"
  }
],
"nextCursor": "eyJpZCI6IlNUTTIwMjYwNDE4IiwiY3JlYXRlZEF0IjoiMjAyNi0wNC0xOFQwOToxNTowMCswODowMCIsImRpciI6ImFmdGVyIn0="
}