After a certificate of origin PDF has been created, you will receive a CoOPDFCreated notification event (see Notification events). The event data includes a url field pointing to the generated document.

Downloading the document

There are two ways to download a certificate of origin document:

Scope: read:documents

Direct download (307 redirect)

GET /v1/certificates-of-origin/{certificateOfOriginId}/{attachmentId}

View in API reference

This returns an HTTP 307 Temporary Redirect to a time-limited download URL. Your HTTP client must follow redirects automatically to download the file.

Get download URL

GET /v1/certificates-of-origin/{certificateOfOriginId}/{attachmentId}/url

View in API reference

This returns a JSON response containing the temporary download URL without redirecting:

{
    "url": "https://temporary-download-url..."
}

Use this approach if your HTTP client does not support automatic redirects.

Using the notification event URL

The CoOPDFCreated notification event includes a url field in its data payload. This URL corresponds to the direct download endpoint above. You can extract the certificateOfOriginId and attachmentId from the URL path, or use the URL directly.

For HTTP status codes and error response formats, see Error handling.