Salesforce Reports and Dashboards REST API Developer Guide
Summer '26 (API version 67.0)
Spring '26 (API version 66.0)
Winter '26 (API version 65.0)
Summer '25 (API version 64.0)
Spring '25 (API version 63.0)
Winter '25 (API version 62.0)
Summer '24 (API version 61.0)
Spring '24 (API version 60.0)
Winter '24 (API version 59.0)
Summer '23 (API version 58.0)
Spring '23 (API version 57.0)
Winter '23 (API version 56.0)
Summer '22 (API version 55.0)
Spring '22 (API version 54.0)
Winter '22 (API version 53.0)
Summer '21 (API version 52.0)
Spring '21 (API version 51.0)
Winter '21 (API version 50.0)
Summer '20 (API version 49.0)
Spring '20 (API version 48.0)
Winter '20 (API version 47.0)
Summer '19 (API version 46.0)
Spring '19 (API version 45.0)
Winter '19 (API version 44.0)
Summer '18 (API version 43.0)
Spring '18 (API version 42.0)
Winter '18 (API version 41.0)
Summer '17 (API version 40.0)
Spring '17 (API version 39.0)
Winter '17 (API version 38.0)
Summer '16 (API version 37.0)
Spring '16 (API version 36.0)
Winter '16 (API version 35.0)
Summer '15 (API version 34.0)
Spring '15 (API version 33.0)
Winter '15 (API version 32.0)
Spring '14 (API version 30.0)
Create a New Report
Run Reports Synchronously or Asynchronously
Get Report Metadata
Get a List of Report Types
Download Formatted Excel Reports Using the Reports REST API
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
Save Changes to Reports
Clone Reports
Delete Reports
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
You can use the Reports REST API to request reports in printer-friendly Excel format. -
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.