GET https://api.digicert.com/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}/download?report_format={{report_format}}

• To download the report as a single file, pass the file format (CSV, JSON, or EXCEL) as the value of the report_format query string.

• To download a compressed .zip file with the report data, pass a value of ZIP for the report_format query string.

You can only download reports in the format chosen when you created the report. To get the report format, use the Report details endpoint (see format).

### Important

JSON, CSV, and Excel files larger than 2 MB always download in a compressed .zip file, regardless of the value of the report_format query string.

## Reports with multiple files

Reports with many rows are split into multiple files. For these reports, you must download each file one at a time. Reports with multiple files always download in a compressed .zip file.

To specify which file in the sequence to download, include the split_report_sequence query string in the request URL. Set its value to the sequence number of the file to download. The sequence number starts at 0 for the first file, and can increase up to n, where n is the number for the last file in the sequence. To see how many files a report run is split into, see the split_report_count parameter in the List report history response.

For example, use this query string to download the third file (sequence number = 2) in the sequence:

https://api.digicert.com/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}/download?report_format={{report_format}}&split_report_sequence=2


The threshold for splitting reports into multiple files varies by report type:

Report type

Maximum number of rows per file

Orders

100,000

Domains

1,000,000

Balance history

1,000,000

Audit logs

1,000,000

Organizations

1,000,000

FQDN*

--

### Note

*FQDN reports are never split into multiple files. For more information, see Report Library API - Report formats.

{{display name}}-{{download date as YYYY-MM-DD}}.{{file_extension}}


The file extension is based on the report_format. For example: Single_file_report-2021-01-27.csv

If the report is split into multiple files, each file in the sequence is downloaded as compressed .zip. The filename is appended with an _n, where n is replaced with the sequence number of the downloaded file. For example: Multi_file_report-2021-01-27_5.zip

## Path parameters

Name

Req/Opt

Description

report_identifier

required

report_run_identifier

required

## URL query parameters

Name

Req/Opt

Type

Description

report_format

required

string

Format of the downloaded report. Must be the format you chose when you created the report.

Allowed values: JSON, CSV, EXCEL, or ZIP

split_report_sequence

optional

integer

Sequence number of the file to download. The sequence number starts at 0 for the first file, and can increase up to n, where n is the number for the last file in the sequence. To see how many files a report run is split into, see the split_report_count parameter in the List report history response.