---
title: Download document
description: "Once the document is signed it can be downloaded by Portal application. GET method */JSON/document/{id})* is used to download the (binary) content of the signed document. ## Service specification: | URL | https://apidev.okdokument.com/JSON/document/{documentId} | | --- | --- | |…"
url: "https://wiki.signatus.com/documentation/okdokument-api/2-6-download-document/"
updated: "2026-05-08"
category: 2. Core API services
---

# Download document

Once the document is signed it can be downloaded by Portal application. GET method */JSON/document/{id})* is used to download the (binary) content of the signed document.

## Service specification:

| URL | https://apidev.okdokument.com/JSON/document/{documentId} |
| --- | --- |
| Method | GET |
| Authentication | Header x-api-key |
| Response Type | application/json |

## Request description

Request path variable:

| Key | Type | Description |
| --- | --- | --- |
| documentId | path | The documentId retrieved from the response body of the Create signature request service |

 HTTP- Click to view HTTP code snippet

```
GET /JSON/document/y7Ki_u1mrUwijfb-o_S1JiphSsoXya8iypH380F HTTP/1.1
Host: localhost:8080
x-api-key: 7796b696_bd2b1aaf7ef4f09be9f52ce2d8d599674d81aa9d6a4421696dc4d93dd0619d682ce56b4d64a9ef097761ced99e0f67265b5f76085e5b0ee7ca4696b2ad6fe2b2
```

## Response description

| Status code | Description |
| --- | --- |
| 200 OK | Pdf document binary data |
| 401 Unauthorized | When user is not authenticated |
| 403 Forbidden | When user lacks required permissions |
| 404 Not Found | If the document with the specified id does not exist. |
| 500 Internal Server Error | Server processing error |

Error response example :

```
{
    "message": "err.not.found",
    "value": "00h2dY9Zo8KN-MXBFTX1SXhA-9WZo8Fsf98H-JGgpiNr5MVqpBPnEbLTxMPZZtN8BjI2LSBIWeOkIQ1pipsXBobY9HiPcHPQXwDpJGeezw8333"
}
```
