Skip to main content

Get Report Run


Get Report Run

Contact Zuora Global Support to enable this feature in your tenant. This feature is currently in development and is subject to change without advance notice.

The Get Report Run Reporting API returns details of the specified report run. You can use Get Report Run to check the status of a report run. To retrieve the results of a completed report run, use Get Report Data or Export Report Run.

To retrieve details of the last completed run of a report, use Get Last Completed Report Run.


Environment Request
API Sandbox (US Data Center) GET{reportRunId} 
Production (US Data Center) GET{reportRunId}
API Sandbox (EU Data Center) GET{reportRunId}
Production (EU Data Center) GET{reportRunId}
API Sandbox(US Cloud Data Center) GET{reportRunId} 
Production (US Cloud Data Center) GET{reportRunId}

Request Parameter




The ID of the report run. You can get the ID from the JSON response to Run a Report.


The JSON response contains the following details about the report run:

Response Field Description


The ID of the report run. This value matches the value of the reportRunId request parameter.


The status of the report run:

  • "STARTED" - The report run has started. The query has not been submitted.
  • "QUERYDATA" - The query has been submitted. The results have not been received.
  • "PROCESSINGDATA" - The results have been received. The results are being processed.
  • "COMPLETED" - The report run has finished successfully. The results are available for download using Get Report Data or Export Report Run.
  • "CANCELLED" - The report run was canceled by the user.
  • "INVALID" - The report definition or data is invalid.
  • "ERROR" - The report run has finished with an error.


The timestamp of when the report run was started.


The timestamp of when the status of the report run was last updated.


The ID of the report that was run.


The report type: "Detail" or "Summary".


The report definition.


HTTPS request:


JSON response:

  "success": true,
  "response": {
    "reportType": "Detail",
    "id": "ff808081529f4e3401529fd61f080074",
    "reportId": "ff808081529f4e3401529fd373730070",
    "startedOn": 1453166692000,
    "status": "COMPLETED",
    "reportDefinition": "...",
    "updatedOn": 1453166695000