Most requests in the Report Library API interact with the resource for a report or a report run. Reports and report runs use the same data structure and have many of the same attributes, with a few key differences. Understanding these differences can help you know which resource to use in your API requests.
The Get report history endpoint returns a list of records for both scheduled reports and completed report runs.
When you call the Create report endpoint, you create a record for a new report. The report record is the template for the data you want to get from your CertCentral account. The report record defines the report type, file format, schedule, and columns (data fields) to include in the report. The report record also defines the filters and data sources (subaccounts and divisions) to use in the report.
Each report has a unique
report_identifier (UUID). Use the
report_identifier with these endpoints:
Each time a report generates results, it creates a new object with details about the report run. Report runs can be scheduled, or you can start them on demand. Successful report runs create files containing the results of the report. You can download these files from your CertCentral account.
Each report run has a unique
report_run_identifier (UUID). Use the
report_run_identifier with these endpoints:
When you schedule a report to run on-demand, the first report run starts the moment the report is created. This means:
report_run_identifierof the first report run.