# Reporting The Zuora Reporting API enables you to access reports that you have created in the Zuora UI, manage report runs, and export the results of report runs. The endpoints of the Reporting API are the same as the [endpoints of Zuora REST API](https://developer.zuora.com/api-references/api/overview/#section/Introduction/Access-to-the-API). The following table provides some endpoints as reference: | Environment | API Endpoint | | ------------------------------------ | ----------------------------------------------------------- | | API Sandbox (US Cloud Data Center 1) | https://rest.sandbox.na.zuora.com | | Production (US Cloud Data Center 1) | https://rest.na.zuora.com | | API Sandbox (US Cloud Data Center 2) | https://rest.apisandbox.zuora.com | | Production (US Cloud Data Center 2) | https://rest.zuora.com | | API Sandbox (EU Data Center) | https://rest.sandbox.eu.zuora.com | | Production (EU Data Center) | https://rest.eu.zuora.com | | US Central Sandbox | https://rest.test.zuora.com | | EU Central Sandbox | https://rest.test.eu.zuora.com | | APAC Developer & Central Sandbox | https://rest.test.ap.zuora.com | | APAC Production | https://rest.ap.zuora.com | Historically, the endpoints of the Reporting API were different from the endpoints of the Zuora REST API. Note that you are still able to use the following endpoints, but it is unrecommended and you can only use username and password to authenticate to the Reporting API. We recommend you to use [OAuth](https://developer.zuora.com/rest-api/general-concepts/authentication/) to authenticate to the Reporting API. OAuth only works with new endpoints. The endpoints of the Reporting API were: | Environment | API Endpoint | | ------------------------------------ | ----------------------------------------------------------- | | API Sandbox (US Cloud Data Center 1) | https://zconnect.sandbox.na.zuora.com/api/rest/v1 | | Production (US Cloud Data Center 1) | https://zconnect.na.zuora.com/api/rest/v1 | | API Sandbox (US Cloud Data Center 2) | https://zconnectsandbox.zuora.com/api/rest/v1 | | Production (US Cloud Data Center 2) | https://zconnect.zuora.com/api/rest/v1 | | API Sandbox (EU Data Center) | https://zconnect.sandbox.eu.zuora.com/api/rest/v1 | | Production (EU Data Center) | https://zconnect.eu.zuora.com/api/rest/v1 | | US Central Sandbox | https://zconnect-services0001.test.zuora.com/api/rest/v1 | | EU Central Sandbox | https://zconnect-services0002.test.eu.zuora.com/api/rest/v1 | | APAC Developer & Central Sandbox | https://zconnect-services0003.test.ap.zuora.com | | APAC Production | http://zconnect-prod05.ap.zuora.com | ## Retrieve a report run - [GET /reporting/api/rest/v1/reportruns/{reportRunId}](https://developer.zuora.com/v1-api-reference/older-api/reporting/get_reportrun.md): Retrieves details of the specific report run. ## Cancel a report run - [DELETE /reporting/api/rest/v1/reportruns/{reportRunId}](https://developer.zuora.com/v1-api-reference/older-api/reporting/delete_reportrun.md): Stops the specified report run. ## Run a report - [POST /reporting/api/rest/v1/reports/{ReportId}/reportrun](https://developer.zuora.com/v1-api-reference/older-api/reporting/post_reportrun.md): Starts a new report run and returns the ID of the report run. ## Search reports by name - [GET /reporting/api/rest/v1/reports/search](https://developer.zuora.com/v1-api-reference/older-api/reporting/get_reportsbyname.md): Retrieves all reports that match a query based on the report name, description, or data source name. Reports are not required to have unique names or descriptions and so this search will typically return many report matches because of matches from multiple fields unless you specify a unique query keyword. Optionally you can specify sorting on either the name or the updated_on fields. The search is automatically limited to the first 50 results. If you want to query for the next 50, you have to set the searchStart parameter to 50 and submit another request to get the next 50 results. ## Retrieve the last completed report run - [GET /reporting/api/rest/v1/reports/{reportId}/reportruns/latest](https://developer.zuora.com/v1-api-reference/older-api/reporting/get_latestreportrun.md): Retieves the ID of the last completed run of a report by the current user in the last 60 days. ## Retrieve report data - [GET /reporting/api/rest/v1/reportruns/reportdata/{ReportRunId}](https://developer.zuora.com/v1-api-reference/older-api/reporting/get_reportdata.md): Returns the report run results for the specified report run. ## Export results of a report run - [GET /reporting/api/rest/v1/reportruns/export/{ReportRunId}](https://developer.zuora.com/v1-api-reference/older-api/reporting/get_exportreportrun.md): Retrieves report run results as comma separated values. ## Transfer report ownership - [POST /reporting/api/rest/v1/reports/transfer-ownership](https://developer.zuora.com/v1-api-reference/older-api/reporting/transferreportownership.md): Transfers ownership of one or more reports to a different user. You can transfer ownership using either reportNames or reportIds. Authorization requirement: The user who obtains the OAuth token must have the Zuora Reporting Administrator role. To get the userId of the new owner, navigate to: Administration Settings > Manage Users > Click the new owner name > In the URL, locate the id value: https://{zuora_endpoint}/apps/UserLogin.do?method=view&id=&... That id is the newOwnerUserId. For detailed usage examples including curl commands, see the Transfer Report Ownership Zuora Knowledge Center article.