Understanding Reports REST API Resources

The Reports API is designed to let you query report data easily. Use the Reports API to:

• Run Reports Synchronously or Asynchronously.

  Run a report immediately or asynchronously to get summary data with or without details. We recommend that you run reports asynchronously to avoid report timeouts and other API limits.

• Get Report Metadata.

  Get information about fields in the report and report type. This includes information about fields used for report groupings, summaries, detailed data, and filters.

• List Asynchronous Runs of a Report.

  Get a list of all instances of a report run asynchronously.

• Filter Reports on Demand.

  Get specific data back by running a report with filter changes in the metadata.

• List Recently Viewed Reports.

  Get most recently viewed reports that you have permission to access.

• Decode the Fact Map.

  Get a visualized view of your report data.