# 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](/docs/analytics/salesforce-analytics-rest-api/guide/analytics-api-report-example-post-report.md)**

  Create a new report using a POST request.

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

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

- **[Get a List of Report Types](/docs/analytics/salesforce-analytics-rest-api/guide/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](/docs/analytics/salesforce-analytics-rest-api/guide/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](/docs/analytics/salesforce-analytics-rest-api/guide/sforce-analytics-rest-api-list-asyncreportruns.md)**

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

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

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

- **[Get Report Data without Saving Changes to or Creating a Report](/docs/analytics/salesforce-analytics-rest-api/guide/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](/docs/analytics/salesforce-analytics-rest-api/guide/sforce-analytics-rest-api-save-report.md)**

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

- **[Clone Reports](/docs/analytics/salesforce-analytics-rest-api/guide/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](/docs/analytics/salesforce-analytics-rest-api/guide/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.