Salesforce Reports and Dashboards REST API Developer Guide

Introducing the Salesforce Reports and Dashboards REST API
Understanding Reports REST API Resources
Understanding Dashboards REST API Resources
Reports API Resource Reference
Report
Describe
Execute Sync
Execute Async
Instances List
Instance Results
Report List
Report Error Codes
Dashboards API Resource Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Instance Results

Retrieves results for an instance of a report run asynchronously with or without filters. Depending on your asynchronous report run request, data can be at the summary level or include details.

Resource URL

1/services/data/<latest API version>/analytics/reports/<report ID>/instances/<instance ID>

Formats

JSON

HTTP Methods

Method Description
GET Retrieves results of an asynchronous report run. See this example.

Response Body

Property Type Description
hasDetailRows Boolean
  • When false, report results are at summary level.
  • When true, report results are at the record detail level.
allData Boolean

When True, all report results are returned.

When False, detailed data for the first 2000 report rows are returned.
reportMetadata Report metadata Information about the fields used to build the report.
factMap Fact map Collection of summary level data or both detailed and summary level data.
attributes Attributes Attributes for the instance of the report run.
reportExtendedMetadata Report extended metadata Information on report groupings, summary fields, and detailed data columns, which is available if detailed data is requested.
groupingsDown Groupings down Collection of row groupings.
groupingsAcross Groupings across Collection of column groupings.
Attributes
Property Type Description
id String Unique ID for an instance of a report that was run.
status String
  • New if the report run has just been triggered through a request.
  • Success if the report ran.
  • Running if the report is being run.
  • Error if the report run failed. The instance of a report run can return an error if, for example, your permission to access the report has been removed since you requested the run.
ownerId String API name of the user that created the instance.
completionDate Date, time string Date, time when the instance of the report run finished. Only available if the report instance ran successfully or couldn’t be run because of an error. Date-time information is in ISO-8601 format.
requestDate Date, time string Date and time when an instance of the report run was requested. Date-time information is in ISO-8601 format.
type String Format of the resource.
reportId String Unique report ID.
reportName String Display name of the report.