---
title: "Get Evidence"
slug: "get-evidence"
updated: 2025-06-27T19:54:16Z
published: 2025-06-27T19:54:16Z
canonical: "docs.onespan.com/get-evidence"
---

> ## 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 Evidence

The Get Evidence API retrieves the complete evidence audit trail for a transaction. The evidence is produced as a single evidence pack that contains the full transaction audit trail, signer session recordings, identity validation data, and all additional evidence material.

This API can be called multiple times, but only after the transaction has been completed. The evidence is returned as a PDF file to be downloaded.

## Syntax

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

## Examples

### Example request

```http
GET api/transaction/dcaad720-d1e9-47ba-a76b-a6370ef0373b/document/
AuditTrailDocument/pdf/ HTTP/1.1
Host: onespan.com
Accept: application/pdf
```

### Example response

```http
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/pdf
  TWFuIGlzIGRpc3Rpbmd1aXNoZWQsIG5vdCBvbmx5IGJ5IGhpcyByZWFzb24sIGJ1dCBieSB0aG
  lzIHNpbmd1bGFyIHBhc3Npb24gZnJvbSBvdGhlciBhbmltYWxzLCB3aGljaCBpcyBhIGx1c3Qg
  b2YgdGhlIG1pbmQsIHRoYXQgYnkgYSBwZXJzZXZlcmFuY2Ugb2YgZGVsaWdodCBpbiB0aGUgY2
  ...
  9udGludWVkIGFuZCBpbmRlZmF0aWdhYmxlIGdlbmVyYXRpb24gb2Yga25vd2xlZGdlLCBleGN1
  ZWRzIHRoZSBzaG9ydCB2ZWhlbWVuY2Ugb2YgYW55IGNhcm5hbCBwbGVhc3VyZS4=
```

### 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): application/json

### 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="9d7e8dfa-a087-492c-b0a1-945c8167754a"><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="dac13432-15ba-4bf5-94c5-0fc5386544b4">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="1f06796b-aa77-4ed4-8d42-cf5f9abf30e2">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="3e538b91-42e8-426b-99bc-88896452c550">Description</p> </th> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="51d09a0e-84c1-4cac-8caa-40842b5c7662"><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="723a9f03-4408-4ddc-94f7-8f91b40821f6"><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="47947422-36c3-42db-b11e-1238f6bb6b97">No error.</p> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="edea607f-3d60-4869-bd14-4034e710748c"><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="03d60b93-6bc8-4482-ad49-47973af1f98f"><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="27e1f068-cdbe-45f5-9a76-1ce7d8c1257c">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="879518ec-57cb-4ce8-986c-e249ce6578b9"><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="72afb844-6e78-4853-b2f7-89c34252bfbe"><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="a430f519-5092-4b95-975a-e2c66679ce86">Invalid token.</p> </td> </tr> <tr> <td colspan="1" rowspan="1" style="vertical-align:middle;text-align:left;"> <p data-block-id="6cec5947-0098-40f5-a43d-f1a7ac115ce3"><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="b2cfc462-f9c7-4bd7-a71c-48cf9132fafe"><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="c8bb7108-e4b2-462b-a0ac-c1eb70e56b8c">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="bafec3ee-b3c9-4017-8459-e6ab081ea2fd"><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="d4dceaf4-5ddc-41be-89c8-8f241f85b19e"><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="4a28e5c9-b933-46ad-b032-f7db655f121a">Server or application error.</p> </td> </tr> </tbody> </table></div></editor360-custom-block>
