reports

Queue a report export

Asynchronously queues a report for exporting. To use this API, first call this endpoint with the type of report you wish to generate and any other filtering parameters. You can optionally specify a list of email addresses or a URL that will receive a POST request when the export completes.

When a report is queued, you will receive a unique queued_report_id. Use this ID to check the status of the export using the /reports/status endpoint.

Required API key permissions: Platform (select when creating API key in Account Settings)

post/reports/queue

Request

Query parameters

report_type'BoardSummaryPDF' | 'BoardSummaryPPTX' | 'BreachSightSummaryPDF' | 'BreachSightDetailedPDF' | 'VendorRiskExecutiveSummaryPDF' | 'VendorSummaryPDF' | 'VendorDetailedPDF' | 'VendorRiskAssessmentPDF' | 'CustomPDF' | 'VendorRiskProfileXLSX' | 'VendorVulnsOverviewXLSX' | 'VendorDomainListPDF' | 'QuestionnaireDetailsPDF' | 'QuestionnaireDetailsXLSX' required

The type of report to export. Note that each report type may require different parameters to be specified in the request.

When VendorRiskAssessmentPDF is selected the latest published risk assessment will be used, if no published risk assessment is available for the selected vendor a 422 error will be returned.

custom_report_uuidstring

For an export of type 'CustomPDF', specify the UUID of the custom report to generate. This is a required field for the custom report type.

email_addressesstring[]

Optionally email the generated report to the specified addresses when it is ready.

post_webhook_urlstring uri

Optionally specify a URL that will receive a POST request when the report is ready. The request will contain a JSON body containing a URL to download the report, in the following format:

{
"queued_report_id": "string",
"download_url": "url"
"download_url_expires": "string"
}
asset_portfolio_namesstring[]

Filter by asset portfolio names. Case-sensitive. Optional. Applicable only when report_type is BreachSightSummaryPDF or BreachSightDetailedPDF.

vendor_portfolio_namesstring[]

Filter by vendor portfolio names. Case-sensitive. Optional. Applicable only when report_type is BoardSummaryPDF, BoardSummaryPPTX, or VendorRiskExecutiveSummaryPDF.

vendor_idinteger

ID of the vendor to generate the report for. Either this, vendor_primary_hostname or filter_by_vendor_hostnames are required when report_type is VendorSummaryPDF, VendorDetailedPDF, VendorRiskAssessmentPDF, CustomPDF, VendorRiskProfileXLSX, VendorVulnsOverviewXLSX, VendorDomainListPDF, QuestionnaireDetailsPDF or QuestionnaireDetailsXLSX.

vendor_primary_hostnamestring

Primary hostname of the vendor to generate the report for. Either this, vendor_id or filter_by_vendor_hostnames are required when report_type is VendorSummaryPDF, VendorDetailedPDF, VendorRiskAssessmentPDF, CustomPDF, VendorRiskProfileXLSX, VendorVulnsOverviewXLSX, VendorDomainListPDF, QuestionnaireDetailsPDF or QuestionnaireDetailsXLSX.

filter_by_vendor_hostnamesstring

List of hostnames from a single vendor to generate the report for. Either this, vendor_id or vendor_primary_hostname are required when report_type is VendorSummaryPDF, VendorDetailedPDF, CustomPDF, VendorRiskProfileXLSX, VendorVulnsOverviewXLSX or VendorDomainListPDF.

filename_prefixstring

String to use as the first part of the report filename. For vendor reports this will precede the vendor name, and for others the account name. A maximum of the first 20 characters (runes) of the supplied string will be used

wait_for_databoolean

When requesting a vendor report, determine if the report should wait for the appropriate data to become available. This is typical of reports where the vendor may have only just become known by the system, or the vendor only just been watched by the account. Typically, the report generation and delivery is delayed by up to 72 hours to allow for the data to become available. This parameter is only valid when report_type is VendorSummaryPDF*, VendorDetailedPDF, CustomPDF, VendorRiskProfileXLSX, VendorVulnsOverviewXLSX, or VendorDomainListPDF.

questionnaire_idinteger

The ID of the questionnaire to generate the report for. Required when report_type is QuestionnaireDetailsPDF or QuestionnaireDetailsXLSX.

include_messagesboolean

Whether to include correspondence messages in the questionnaire details report. Optional. Applicable only when report_type is QuestionnaireDetailsPDF or QuestionnaireDetailsXLSX.

include_private_messagesboolean

Whether to include private/internal messages in the questionnaire details report. Only available to the questionnaire author organization. Optional. Applicable only when report_type is QuestionnaireDetailsPDF or QuestionnaireDetailsXLSX.

Response

Report queued for export

queued_report_idstring

The ID of the queued report. Use this when polling the /reports/status endpoint for a download URL.

Changes

No recorded changes to this operation across all 1 revision of this API.