---
title: "Download report"
source_url: https://dev.digicert.com/certcentral-apis/report-library-api/download-report.html
api_method: GET
api_endpoint: "/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}#download"
api_url: "https://api.digicert.com/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}#download?report_format={{format}}"
---

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

Use this endpoint to download the results of a report run.

- 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](https://dev.digicert.com/md/certcentral-apis/report-library-api/report-details.md) 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](https://dev.digicert.com/md/certcentral-apis/report-library-api/list-report-history.md) 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. Also, for order reports, the maximum number of rows per file is lower if the report includes PEM-encoded certificate data for each order.

<table>
<thead>
<tr>
<th>Report type</th>
<th>Maximum number of rows per file</th>
</tr>
</thead>
<tbody>
<tr>
<td>Orders (with <code>certificate_pem_format</code> column)</td>
<td>10,000</td>
</tr>
<tr>
<td>Orders (without <code>certificate_pem_format</code> column)</td>
<td>200,000</td>
</tr>
<tr>
<td>Domains</td>
<td>50,000</td>
</tr>
<tr>
<td>Balance history</td>
<td>1,000,000</td>
</tr>
<tr>
<td>Audit logs</td>
<td>1,000,000</td>
</tr>
<tr>
<td>Organizations</td>
<td>1,000,000</td>
</tr>
<tr>
<td>Users</td>
<td>1,000,000</td>
</tr>
<tr>
<td>FQDN*</td>
<td>--</td>
</tr>
</tbody>
</table>


> **Info**
>
> *FQDN reports are never split into multiple files. For more information, see [Report Library API - Report formats](https://dev.digicert.com/md/certcentral-apis/report-library-api.md#section-idm4598743083089632783423602974).


## Naming conventions for report downloads

Downloaded report files are saved as:

```
{{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*

## Example requests and responses

## cURL

```
curl --request GET 'https://api.digicert.com/reports/v1/report/{{report_identifier}}/{{report_run_identifier}}#download?report_format={{format}}' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
```

## 200 OK

```
// Report download
```

## Path parameters

<table>
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>report_identifier</td>
<td>required</td>
<td>Report ID (UUID). To get the report ID, copy the <code>report_identifier</code> returned when you <a href="https://dev.digicert.com/md/certcentral-apis/report-library-api/create-report.md">Create a report</a>. Otherwise, use the <a href="https://dev.digicert.com/md/certcentral-apis/report-library-api/list-report-history.md">List report history</a> endpoint.</td>
</tr>
<tr>
<td>report_run_identifier</td>
<td>required</td>
<td>ID of the specific report run to download (UUID). To get the report run ID, use the <a href="https://dev.digicert.com/md/certcentral-apis/report-library-api/list-report-history.md">List report history</a> endpoint.</td>
</tr>
</tbody>
</table>

## URL query parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>report_format</td>
<td>required</td>
<td>string</td>
<td>Format of the downloaded report. Must be the format you chose when you created the report.<br><strong>Allowed values:</strong><code>JSON</code>, <code>CSV</code>, <code>EXCEL</code>, or ZIP</td>
</tr>
<tr>
<td>split_report_sequence</td>
<td>optional</td>
<td>integer</td>
<td>Sequence number of the file to download. The sequence number starts at 0 for the first file, and can increase up to <em>n</em>, where <em>n</em> is the number for the last file in the sequence. To see how many files a report run is split into, see the <code>split_report_count</code> parameter in the <a href="https://dev.digicert.com/md/certcentral-apis/report-library-api/list-report-history.md">List report history</a> response.</td>
</tr>
</tbody>
</table>