> This page is for Docs.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Get Report Run

> A Reporting API that returns details of the specified report run

A Reporting API that returns details of the specified report run

> **Note**
>
> Contact [Zuora Global Support](https://support.zuora.com/) 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](/docs/platform/data/reporting/reporting-api-reference/overview-of-the-zuora-reporting-api/get-report-data)** or **[Export Report Run](/docs/platform/data/reporting/reporting-api-reference/overview-of-the-zuora-reporting-api/export-report-run)**.

To retrieve details of the last completed run of a report, use **[Get Last Completed Report Run](/docs/platform/data/reporting/reporting-api-reference/overview-of-the-zuora-reporting-api/get-last-completed-report-run)**.

## Request

| Environment                       | Request                                                                                                                                                                    |
| --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Sandbox (US Data Center)      | **GET [https://zconnectsandbox.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\}](https://zconnectsandbox.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\})**         |
| Production (US Data Center)       | **GET [https://zconnect.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\}](https://zconnect.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\})**                       |
| API Sandbox (EU Data Center)      | **GET [https://zconnect.sandbox.eu.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\}](https://zconnect.sandbox.eu.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\})** |
| Production (EU Data Center)       | **GET [https://zconnect.eu.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\}](https://zconnect.eu.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\})**                 |
| API Sandbox(US Cloud Data Center) | **GET [https://zconnect.sandbox.na.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\}](https://zconnect.sandbox.na.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\})** |
| Production (US Cloud Data Center) | **GET [https://zconnect.na.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\}](https://zconnect.na.zuora.com/api/rest/v1/reportruns/\\\{reportRunId\\})**                 |

## Request parameter

<table>
  <tr>
    <td>
      **`reportRunId`**
    </td>

    <td>
      required
    </td>

    <td>
      path
    </td>

    <td>
      The ID of the report run. You can get the ID from the JSON response to **[Run a Report](/docs/platform/data/reporting/reporting-api-reference/overview-of-the-zuora-reporting-api/run-a-report)**.
    </td>
  </tr>
</table>

## Response

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

<table>
  <tr>
    <th>
      Response Field
    </th>

    <th>
      Description
    </th>
  </tr>

  <tr>
    <td>
      `id`
    </td>

    <td>
      The ID of the report run. This value matches the value of the `reportRunId` request parameter.
    </td>
  </tr>

  <tr>
    <td>
      `status`
    </td>

    <td>
      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](/docs/platform/data/reporting/reporting-api-reference/overview-of-the-zuora-reporting-api/get-report-data)** or **[Export Report Run](/docs/platform/data/reporting/reporting-api-reference/overview-of-the-zuora-reporting-api/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.
    </td>
  </tr>

  <tr>
    <td>
      `startedOn`
    </td>

    <td>
      The timestamp of when the report run was started.
    </td>
  </tr>

  <tr>
    <td>
      `updatedOn`
    </td>

    <td>
      The timestamp of when the status of the report run was last updated.
    </td>
  </tr>

  <tr>
    <td>
      `reportID`
    </td>

    <td>
      The ID of the report that was run.
    </td>
  </tr>

  <tr>
    <td>
      `reportType`
    </td>

    <td>
      The report type: "Detail" or "Summary".
    </td>
  </tr>

  <tr>
    <td>
      `reportDefinition`
    </td>

    <td>
      The report definition.
    </td>
  </tr>
</table>

## Example

**HTTPS request:**

`GET https://zconnectsandbox.zuora.com/api/rest/v1/reportruns/ff808081529f4e3401529fd61f080074`

**JSON response:**

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