You can now download files through dedicated endpoints using your API key. Each download request uses standard API [authentication](/authentication), giving you a consistent way to retrieve:

- [Signed documents](/openapi/downloads/downloadsigneddocument)
- [Envelopes](/openapi/downloads/downloadenvelope)
- [Original documents](/openapi/downloads/downloadoriginaldocument)
- [Templates](/openapi/downloads/downloadtemplate)
- [Upload field files](/openapi/downloads/downloadfieldupload)


You can find more information in [Download files](/downloads).

### Deprecated fields

The following download URL fields are now deprecated. Use the corresponding endpoint to download each file:

| Deprecated field | Replacement endpoint |
|  --- | --- |
| [`envelope_documents[].document_signed_pdf`](/openapi/envelopes/getenvelope#envelopes/getenvelope/t=response&c=200&path=envelope_documents/document_signed_pdf) | [`GET /envelopes/{envelope_fingerprint}/documents/{document_fingerprint}/download`](/openapi/downloads/downloadsigneddocument) |
| [`envelope_documents[].document_pdf_url`](/openapi/envelopes/getenvelope#envelopes/getenvelope/t=response&c=200&path=envelope_documents/document_pdf_url) | [`GET /envelopes/{envelope_fingerprint}/documents/{document_fingerprint}/original/download`](/openapi/downloads/downloadoriginaldocument) |
| [`envelope_signed_pdf`](/openapi/envelopes/getenvelope#envelopes/getenvelope/t=response&c=200&path=envelope_signed_pdf) | [`GET /envelopes/{envelope_fingerprint}/download`](/openapi/downloads/downloadenvelope) |
| [`templates[].template_pdf_url`](/openapi/templates/listtemplates#templates/listtemplates/t=response&c=200&path=templates/template_pdf_url) | [`GET /templates/{fingerprint}/download`](/openapi/downloads/downloadtemplate) |
| [`template_pdf_url`](/openapi/templates/gettemplate#templates/gettemplate/t=response&c=200&path=template_pdf_url) | [`GET /templates/{fingerprint}/download`](/openapi/downloads/downloadtemplate) |


Customers joining from **30 September 2026** must use the download endpoints. The deprecated fields are not available to these customers.

Existing customers can continue using the deprecated fields, with no migration deadline currently set. We will introduce API versioning first so you can migrate your integration before support for these fields ends.

### Upload field values

For new customers joining from 30 September 2026, [`envelope_documents[].document_fields[].field_value`](/openapi/envelopes/getenvelope#envelopes/getenvelope/t=response&c=200&path=envelope_documents/document_fields/field_value) will no longer return a file URL when `field_type` is `upload`. Instead, it will return the following message:

```json
{
  "field_value": "Files have been uploaded. Download them via the authenticated API: https://api.signable.co.uk/v1/envelopes/{associated-envelope-fingerprint}/download"
}
```

Use the [Upload field files](/openapi/downloads/downloadfieldupload) endpoint to download these files.