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 and Authorization Through Connected Apps and OAuth 2.0.

• Create a New Report

  Create a new report using a POST request.

• Run Reports Synchronously or Asynchronously

• Get Report Metadata

• Get a List of Report Types

  Return a list of analytics notifications using a GET request.

• Download Formatted Excel Reports Using the Reports REST API

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

• List Asynchronous Runs of a Report

• Filter Reports on Demand

• List Recently Viewed Reports

• Decode the Fact Map

• Get Report Data without Saving Changes to or Creating a Report

  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

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

• Clone Reports

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

• Delete Reports

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