Query a Report

Retrieve the status and details of a single report task by its ID. Poll this endpoint after Create a Report until report.status becomes SUCCESS, then download the file by sending a GET request directly to report.downloadUrl before it expires.
Request Parameters
idstring
required
Unique report task identifier returned by Create a Report.
Response Parameters
resultResult
See Result.
reportReport
Report task details.
Show child parametersShow child parameters
Error Codes
resultCoderesultStatusresultMessageTroubleshooting
SUCCESSSsuccessN/A
PARAM_ILLEGALFIllegal parameter. Refer to the API documentation to verify the request header and parameters, then retry.Ensure `id` is present and correctly formatted.
ORDER_NOT_EXISTFThe specified order does not exist. Verify the id and retry.Confirm the `id` was returned by Create a Report and belongs to the current account.
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/query
Request
{
"id": "RPT202608080000****"
}
Response
{
"result": {
  "resultCode": "SUCCESS",
  "resultMessage": "success",
  "resultStatus": "S"
},
"report": {
  "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",
  "downloadUrl": "https://example.com/files/****1234.csv",
  "downloadUrlExpiresAt": "2026-08-09T12:08:56+08:00",
  "createdAt": "2026-08-08T12:08:56+08:00"
}
}