---
title: "Get Document"
slug: "get-document"
updated: 2025-06-27T19:56:01Z
published: 2025-06-27T19:56:01Z
canonical: "docs.onespan.com/get-document"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Document

The Get Document API retrieves metadata and content of a document that is being processed in a transaction. The request needs to contain the document ID and the transaction ID.

The document is a fundamental resource in the OneSpan platform domain model (see [Document model](/v1/docs/document-model)).

## Syntax

```http
GET /api/transaction/uuid: transaction_id/document/document_id/pdf
```

## Examples

### Example request

```http
GET /api/transaction/dcaad720-d1e9-47ba-a76b-a6370ef0373b/document/ee02adab-4946-4fae-884f-d8990aaf776a/pdf HTTP/1.1
Host: onespan.com
Accept: application/json, text/javascript
```

### Example response

```http
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json; charset=UTF-8
```

The response body contains the requested document.

### Headers

The following headers are included in the request and the response:

#### Request headers

- [Accept](https://tools.ietf.org/html/rfc7231#section-5.3.2): The response content type depends on the Accept header.
- [Authorization](https://tools.ietf.org/html/rfc7235#section-4.2): The OAuth/JWT token to authenticate.

#### Response Headers

- [Content-Type](https://tools.ietf.org/html/rfc7231#section-3.1.1.5): Depends on the Accept header of the request.

### Status codes

<editor360-custom-block data-preprocessing="true" data-sanitizationtags="a"><div data-type="table-content"> <table width="100%" class=" fr-alternate-rows editor360-table" borderstyle="Solid"> <colgroup style="display:none;"> <col style="width:250px;"> <col style="width:250px;"> <col style="width:250px;"> </colgroup> <tbody> <tr> <td colspan="3" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="ad8eda68-1440-456c-8aac-0cdc06f14416"><a name="Tab_Status_codes" display="false"></a><strong>Status codes</strong></p> </td> </tr> <tr> <th colspan="1" rowspan="1" class="TableStyle-Global-HeadE-Column-MainHeader" style="vertical-align:middle;text-align:left;"> <p data-block-id="7f30a5d4-cb76-4b7a-a8c0-7cd030f3687d">Status code</p> </th> <th colspan="1" rowspan="1" class="TableStyle-Global-HeadE-Column-MainHeader" style="vertical-align:middle;text-align:left;"> <p data-block-id="4eb7c531-68aa-47bd-99d3-03152e896fec">Name</p> </th> <th colspan="1" rowspan="1" class="TableStyle-Global-HeadD-Column-MainHeader" style="vertical-align:middle;text-align:left;"> <p data-block-id="e0b63d4a-da68-4e2c-a486-954cff975163">Description</p> </th> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="1c06f88a-992b-4ebf-8b55-23be09608fcd"><span class="vdsCodeBasic" type="spanMark">200</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="416447af-8aaf-484b-a4dc-5c274d059f55"><span class="vdsCodeBasic" type="spanMark">OK</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="b6d3c0a7-5069-4ba0-8287-a3d7953e4464">No error.</p> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="7c65cfc9-62a5-476a-8084-67208754facc"><span class="vdsCodeBasic" type="spanMark">400</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="7c465c29-6352-44af-9e3d-6a373066eaf6"><span class="vdsCodeBasic" type="spanMark">Bad Request</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="7098ff24-7cd7-4701-815a-0db7499adb5a">The transaction data is invalid.</p> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="01a97f90-7b6b-4047-a96b-ce7276d30440"><span class="vdsCodeBasic" type="spanMark">401</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="3a8fb828-1e21-46b0-ad90-97b5ff307b94"><span class="vdsCodeBasic" type="spanMark">Unauthorized</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="1b9f4ef1-56f4-4e57-9aa1-31e160972641">Invalid token.</p> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="eb05ebc9-2275-407a-978a-1aa41904f14c"><span class="vdsCodeBasic" type="spanMark">403</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="a8fe246b-7890-492a-88cf-01af37f083a5"><span class="vdsCodeBasic" type="spanMark">Forbidden</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="4f89340b-f9b2-47d6-be4a-36091a2733d4">The token does not grant transaction creation rights.</p> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="9f0ace8a-0afb-4a0e-892e-e047f695aefe"><span class="vdsCodeBasic" type="spanMark">500</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="96a19194-d32f-4999-8f12-4e76c5c5753e"><span class="vdsCodeBasic" type="spanMark">Internal Server Error</span></p> </td> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="f584e277-e754-4e09-9586-e6bfb059ce32">Server or application error.</p> </td> </tr> </tbody> </table></div></editor360-custom-block>
