---
title: "Start report run"
source_url: https://dev.digicert.com/certcentral-apis/report-library-api/start-report-run.html
api_method: POST
api_endpoint: "https: //api.digicert.com/reports/v1/report/{{report_identifier}}/run"
api_url: "https: //api.digicert.com/reports/v1/report/{{report_identifier}}/run"
---

**POST** `https: //api.digicert.com/reports/v1/report/{{report_identifier}}/run`

Use this endpoint to start a report run on-demand.

## Example requests and responses

## cURL

```
curl --request POST 'https: //api.digicert.com/reports/v1/report/{{report_identifier}}/run' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
```

## 200 Created

```
{
    "report_identifier": "88de5e19-ec57-4d70-865d-df953b062574",
    "message": "Successfully triggered report creation"
}
```

## 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>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>report_identifier</td>
<td>string</td>
<td>Report ID.</td>
</tr>
<tr>
<td>message</td>
<td>string</td>
<td>Success message.</td>
</tr>
</tbody>
</table>