Newer Version Available

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

Requirements and Limitations

The Salesforce1 Reporting API is available for any organization that has API enabled. You must establish an authenticated session using OAuth in order to access the Salesforce1 Reporting API. When working with the Salesforce1 Reporting API, consider these restrictions in addition to general API limits.

Responses and requests are in JSON. While using the Salesforce1 Reporting API with a POST request body, you must use content-type: application/json. You might get unexpected results if you don’t use this content type.

Note

Reports Limits
  • Cross filters, standard report filters, and filtering by row limit are unavailable when filtering data.
  • Historical trend reports are only supported for matrix reports.
  • The API can process only reports that contain up to 100 fields selected as columns.
  • A list of up to 200 recently viewed reports can be returned.
  • Your organization can request up to 500 synchronous report runs per hour.
  • The API supports up to 20 synchronous report run requests at a time.
  • A list of up to 2,000 instances of a report that was run asynchronously can be returned.
  • The API supports up to 200 requests at a time to get results of asynchronous report runs.
  • Your organization can request up to 1,200 asynchronous requests per hour.
  • Asynchronous report run results are available within a 24-hour rolling period.
  • The API returns up to the first 2,000 report rows. You can narrow results using filters.
  • You can add up to 20 custom field filters when you run a report.
Dashboards Limits
  • Your organization can request up to 200 dashboard refreshes per hour.
  • Your organization can request results for up to 5,000 dashboards per hour.

All limits that apply to reports created in the report builder also apply to the API, as do limits for dashboards created in the dashboard builder. For more information, see “Salesforce1 Reporting Limits” in the Salesforce online help.

Note