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_identifier
of the first report run.report_run_identifier
value.