# Download an IDPass certificate as PDF

`GET /idpasses/{idpass_uuid}/pdf`

- Base: `GET https://portal.watcheye.com.au/api/v1/idpasses/{idpass_uuid}/pdf`

Returns the verification certificate PDF for a completed IDPass.

This endpoint does not bill - the certificate is generated from the on-record IDPass data.

## Status codes

* `200` - the PDF certificate is returned in the response body.
* `404` - the IDPass does not exist on the calling account.
* `409` - the IDPass has not yet reached a terminal status. Poll
  [show IDPass](/docs/reference/idpass.show) until `status` is terminal, then retry the download.

## Parameters

| Name | In | Type | Description |
|------|----|------|-------------|
| `idpass_uuid` | path | string (uuid) | **Required.** The uuid of the IDPass. |

## Responses

### 200 PDF certificate

Content type: `application/pdf`

Binary PDF file

### 409 The IDPass has not yet completed. Poll the show endpoint until `status` is terminal before retrying the download.

Content type: `application/json`

| Field | Type | Description |
|-------|------|-------------|
| `message` | string | Example: `The IDPass has not completed yet. Wait for a terminal status before downloading the certificate.` |

**Sample response**

```json
{
    "message": "The IDPass has not completed yet. Wait for a terminal status before downloading the certificate."
}
```

Standard error responses: 401, 403, 404, 429, 5XX (see [Common error responses](/docs/reference/general/common-error-responses.md))