---
schema_version: "1"
id: 3f1570058858eb0612d389d8139a7956455f84218f99fbd39d41b01d82fb8bd9
title: Reports Examples
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/analytics/api_analytics/guides/examples/examples-analytics-rest-api-reports-intro.md
canonical_url: https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/examples-analytics-rest-api-reports-intro.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: fed32cf9706cfb9a1bae3cf0ef94d2f794b45b8fee758e9c09a31e75b2db08d9
products:
  - Salesforce Reports and Dashboards REST API Developer Guide
  - analytics
---

# Reports Examples

Learn how to run, create, edit, or delete reports with the Reports REST API. Running a report returns a fact map that describes report data. Learn how to read report fact maps.

For information about different ways to execute the Reports REST API, see [Send REST Request with cURL](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_curl.htm) and [Authorization Through Connected Apps and OAuth 2.0](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_oauth_and_connected_apps.htm).

-   **[Create a New Report](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/analytics-api-report-example-post-report.md)**  


    Create a new report using a POST request.

-   **[Run Reports Synchronously or Asynchronously](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-get-reportdata.md)**  

-   **[Get Report Metadata](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-get-reportmetadata.md)**  

-   **[Get a List of Report Types](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/analytics-api-reporttypes-example-get-reporttypes.md)**  


    Return a list of analytics notifications using a GET request.

-   **[Download Formatted Excel Reports Using the Reports REST API](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-download-excel.md)**  


    Use the Reports REST API to download report results as JSON or Excel.

-   **[List Asynchronous Runs of a Report](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-list-asyncreportruns.md)**  

-   **[Filter Reports on Demand](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-filter-reportdata.md)**  

-   **[List Recently Viewed Reports](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-list-recentreports.md)**  

-   **[Decode the Fact Map](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-factmap-example.md)**  

-   **[Get Report Data without Saving Changes to or Creating a Report](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-report-query-example.md)**  


    Run a report without creating a report or changing an existing one by making a POST request to the `query` resource. Get report data without filling up your org with unnecessary reports.

-   **[Save Changes to Reports](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-save-report.md)**  


    Save changes to a report by sending a PATCH request to the Report resource.

-   **[Clone Reports](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-clone-report.md)**  


    Creates a copy of a custom, standard, or public report by sending a POST request to the Report List resource.

-   **[Delete Reports](https://developer.salesforce.com/docs/analytics/salesforce-analytics-rest-api/guide/reports/sforce-analytics-rest-api-delete-report.md)**  


    Delete a report by sending a DELETE request to the Report resource. Deleted reports are moved to the Recycle Bin.