List Reports

Retrieve a paginated list of report tasks created by the current account, ordered by creation time (most recent first). Use the cursor fields to page through results. Download links are not included in list responses; call Query a Report to obtain a fresh downloadUrl for a specific report.
Request Parameters
limitinteger
Maximum number of records to return per page. Range: 1–100. Defaults to 20 if not provided.
cursorstring
Pagination cursor. Omit for the first page; pass the nextCursor or prevCursor from a previous response to fetch the adjacent page. Max length: 2048 characters.
fromCreatedAtdatetime
Filter for report tasks created at or after this time, following the ISO 8601 standard. See Data Types.
toCreatedAtdatetime
Filter for report tasks created at or before this time, following the ISO 8601 standard. See Data Types.
Response Parameters
resultResult
See Result.
itemsarray
List of report tasks matching the query. In list responses, download links are not included; call Query a Report to obtain them.
Show child parametersShow child parameters
nextCursorstring
Cursor for the next page. Returned when more records are available; pass it as cursor to fetch the next page. Absent on the last page.
prevCursorstring
Cursor for the previous page. Returned when a previous page exists; pass it as cursor to fetch the previous page.
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
PARAM_ILLEGALFIllegal parameter. Refer to the API documentation to verify the request header and parameters, then retry.Ensure `limit` is within 1–100 and `cursor` is a value returned by a previous response.
USER_NOT_EXISTFThe specified user does not exist. Verify the credentials and retry.Verify your authentication credentials and the `account-id` header.
AUTHORIZATION_NOT_EXISTFThe authorization does not exist. Verify the OAuth token and retry.Verify the `access-token`; re-authorize if it has expired.
PROCESS_FAILFA general business failure occurred. Do not retry.Do not retry. Contact customer support if the issue persists.
Definition
POST /api/open/v1/reports/list
Request
{
"limit": 10,
"fromCreatedAt": "2026-08-01T00:00:00+08:00",
"toCreatedAt": "2026-08-08T23:59:59+08:00"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"items": [
  {
    "id": "RPT202608080000****",
    "status": "SUCCESS",
    "reportType": "ACCOUNT_STATEMENTS_REPORT",
    "fileFormat": "CSV",
    "fileName": "STATEMENTS_2026-08-01_2026-08-08",
    "fromDate": "2026-08-01",
    "toDate": "2026-08-08",
    "createdAt": "2026-08-08T12:08:56+08:00"
  }
],
"nextCursor": "eyJpZCI6IjQ1NiJ9"
}