---
title: "Cannot Download Document"
description: "SignatureAPI could not download a document from its url. Make sure the URL is public, unexpired and returns the file, or use an upload instead."
canonical: "https://signatureapi.com/docs/v1/errors/cannot-download-document"
source: "https://signatureapi.com/docs/v1/errors/cannot-download-document.md"
last_verified_api_version: "1.18.0"
last_modified: "2026-11-18T11:41:57Z"
---

# Cannot Download Document

SignatureAPI could not download a document from its url. Make sure the URL is public, unexpired and returns the file, or use an upload instead.

_Last verified against API version 1.18.0._

## What Happened

The server could not download a document from the `url` property of the document in your request. The `detail` property names the document by its position in the `documents` array, such as `documents[0]`, and gives the reason, for example the HTTP status the URL returned.

## Example response

```json 422 Unprocessable Content (application/problem+json)
{
  "type": "https://signatureapi.com/docs/v1/errors/cannot-download-document",
  "title": "Could Not Download Document",
  "status": 422,
  "detail": "documents[0] could not be downloaded: the server responded with HTTP 404"
}
```

## How to Fix

- Open the URL in a browser or run `curl` against it to confirm it returns the file.
- Make sure the URL is public and does not need authentication or cookies.
- If the URL expires, such as a pre-signed link, generate a new one with enough lifetime.
- To send a file that is not public, create an [upload](https://signatureapi.com/docs/api/resources/uploads/object) and use its `url` instead.

Still stuck? [Contact support](https://signatureapi.com/support).
