---
title: "Get document history"
url: "https://docs.signnow.com/docs/document/operations/get-document-historyfull"
type: "endpoint"
section: "document"
slug: "document/operations/get-document-historyfull"
method: "GET"
path: "/document/{document_id}/historyfull"
operation_id: "get-document-historyfull"
authorization: "bearer"
---

# Get document history

`GET /document/{document_id}/historyfull`

This endpoint allows API users to retrieve the full history of a document.

For the events: 

* `signer_authentication_success` 
* `signer_authentication_failure` 

the response may contain an additional parameter `phone_number_2fa` which shows the signer's phone number used for authentication method `phone` or `sms`.

For the event: 

* `signer_authentication_success` 

the response may contain an additional parameter `authentication_code` which shows the code used for authentication method `sms`. The signer receives a code by SMS and enters this code to access the opened document.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `document_id` | string | Yes | ID of the document. |

## Responses

### 200

Returns the history of the document.

For the events `signer_authentication_success` and `signer_authentication_failure`, `json_attributes` may contain `phone_number_2fa`.

**Example** (`Successful response`)

```json
[
  {
    "email": "user1@example.com",
    "event": "created_document",
    "origin": "copy_from_template",
    "created": 1792061346,
    "user_id": "3cc0095f2a88e3eee94525e01cea1d1fbd1833ca",
    "field_id": null,
    "unique_id": "4b7037b36699f404d9e18cc8c93222d72183c8df",
    "element_id": null,
    "ip_address": "34.233.XX.XX",
    "document_id": "e97a6eb321b6ba36b57aa2c9b5bf27f4c00ba813",
    "client_app_name": "SignNow for Procore",
    "json_attributes": null,
    "client_timestamp": null
  },
  {
    "email": "user1@example.com",
    "event": "document_copied_from_template",
    "created": 1792061347,
    "user_id": "3cc0095f2a88e3eee94525e01cea1d1fbd1833ca",
    "field_id": null,
    "unique_id": "7eae1a03d99e7a6eb8e3ddf2bd6a118ac7003b26",
    "element_id": null,
    "ip_address": "34.233.XX.XX",
    "document_id": "e97a6eb321b6ba36b57aa2c9b5bf27f4c00ba813",
    "client_app_name": "SignNow for Procore",
    "json_attributes": null,
    "client_timestamp": 0
  },
  {
    "email": "user1@example.com",
    "event": "document_viewed",
    "created": 1792575308,
    "user_id": "3cc0095f2a88e3eee94525e01cea1d1fbd1833ca",
    "field_id": null,
    "unique_id": "f92f36b5725a4d31e376837fb6a5f1875521d8da",
    "element_id": null,
    "ip_address": "104.30.XX.XX",
    "document_id": "e97a6eb321b6ba36b57aa2c9b5bf27f4c00ba813",
    "client_app_name": "SignNow Web Application",
    "json_attributes": [],
    "client_timestamp": 1792575308
  }
]
```

**Example** (`for the event `signer_authentication_failure``)

```json
[
  {
    "email": "owner_document@email.com",
    "event": "created_document",
    "origin": "original",
    "created": 1672751407,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "021bb62bb8ab01a9ff578f1911947ca471994c6e",
    "element_id": null,
    "ip_address": "5X.XX.XX.XX",
    "document_id": "01cb21a40b890a8b825cd7ae915fe6668c20d6e5",
    "client_app_name": "Sample application",
    "json_attributes": null,
    "client_timestamp": null
  },
  {
    "email": "owner_document@email.com",
    "event": "document_signing_session_completed",
    "created": 1672751421,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "3e03cbc6994e5a905bd2b19e250338012fa56d78",
    "element_id": null,
    "ip_address": "5X.XX.XX.XX",
    "document_id": "01cb21a40b890a8b825cd7ae915fe6668c20d6e5",
    "client_app_name": "Sample application",
    "json_attributes": null,
    "client_timestamp": 1672751421
  },
  {
    "email": "owner_document@email.com",
    "event": "document_invite_sent",
    "created": 1672751636,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "93f16fb90d7cef08d0b85db5525a287b1768c224",
    "element_id": null,
    "ip_address": "5X.XX.XX.XX",
    "document_id": "01cb21a40b890a8b825cd7ae915fe6668c20d6e5",
    "client_app_name": "Sample application",
    "json_attributes": {
      "signers": [
        "signer1@email.com",
        "signer2@email.com"
      ],
      "viewers": []
    },
    "client_timestamp": null
  },
  {
    "email": "signer1@email.com",
    "event": "signer_authentication_failure",
    "created": 1672751775,
    "user_id": "6ad8b8d3d2646cd919c52957eb58eaac08ccf41a",
    "field_id": null,
    "unique_id": "732d92d16e8fb00fd3db804d244204fc3b84ec9f",
    "element_id": null,
    "ip_address": "5X.XX.XX.XX",
    "document_id": "01cb21a40b890a8b825cd7ae915fe6668c20d6e5",
    "client_app_name": "Sample Application",
    "json_attributes": {
      "phone_number_2fa": "+1XXX-XXXXXXX",
      "authentication_type": "sms"
    },
    "client_timestamp": 1672751775
  },
  {
    "email": "signer2@email.com",
    "event": "signer_authentication_failure",
    "created": 1672751811,
    "user_id": "83467d74be676ab81e5f7ebd8806786684b67284",
    "field_id": null,
    "unique_id": "14c58a086f28e5c9b44dcb648481d50846fed13f",
    "element_id": null,
    "ip_address": "5X.XX.XX.XX",
    "document_id": "01cb21a40b890a8b825cd7ae915fe6668c20d6e5",
    "client_app_name": "Sample Application",
    "json_attributes": {
      "phone_number_2fa": "+1XXX-XXXXXXX",
      "authentication_type": "phone_call"
    },
    "client_timestamp": 1672751811
  }
]
```

**Example** (`for the event `signer_authentication_success``)

```json
[
  {
    "email": "document_owner@email.com",
    "event": "created_document",
    "origin": "original",
    "created": 1672128416,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "f397c2ebea78537cc1925ef50a6c203aff4d05c2",
    "element_id": null,
    "ip_address": "35.263.222.70",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample application",
    "json_attributes": null,
    "client_timestamp": null
  },
  {
    "email": "owner_document@email.com",
    "event": "document_signing_session_completed",
    "created": 1672128418,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "b1110ad868b0ea38ddb5b7b492d1197957d9db46",
    "element_id": null,
    "ip_address": "35.263.222.70",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample application",
    "json_attributes": null,
    "client_timestamp": 1672128418
  },
  {
    "email": "owner_document1@email.com",
    "event": "document_invite_sent",
    "created": 1672128439,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "cea079f7507fffb2d5e24631d68c641764fb025d",
    "element_id": null,
    "ip_address": "35.263.222.70",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample application",
    "json_attributes": {
      "signers": [
        "signer1@email.com",
        "signer2@email.com"
      ],
      "viewers": []
    },
    "client_timestamp": null
  },
  {
    "email": "signer1@email.com",
    "event": "signer_authentication_success",
    "created": 1672128445,
    "user_id": "6ad8b8d3d2646cd919c52957eb58eaac08ccf41a",
    "field_id": null,
    "unique_id": "6d146000d6a20e784c5bb7826549cdb747bc3ea6",
    "element_id": null,
    "ip_address": "35.263.222.70",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Signer Application",
    "json_attributes": {
      "phone_number_2fa": "+1XXX-XXXXXXX",
      "authentication_code": "57329",
      "authentication_type": "sms"
    },
    "client_timestamp": 1672128445
  },
  {
    "email": "owner_document@email.com",
    "event": "document_invite_sent",
    "created": 1672128446,
    "user_id": "35c03da2f4e50c17abfa2e64cd62c9f77732b8ad",
    "field_id": null,
    "unique_id": "00fd4459898310ad89193181152d11cbc841fca0",
    "element_id": null,
    "ip_address": "3X.XX.XX.XX",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample Application",
    "json_attributes": {
      "signers": [
        "signer2@email.com"
      ],
      "viewers": []
    },
    "client_timestamp": null
  },
  {
    "email": "signer1@email.com",
    "event": "added_signature",
    "created": 1672128446,
    "user_id": "6ad8b8d3d2646cd919c52957eb58eaac08ccf41a",
    "field_id": "6b169f2eed12d3b096c7ddccda053ce5b35e374e",
    "unique_id": "4056804de8abcb2f6a65681b3de4c3ff56342009",
    "element_id": "791c41fc625a1d629148c281d2ceb26df606d663",
    "ip_address": "3X.XX.XX.XX",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample Application",
    "json_attributes": null,
    "client_timestamp": 1672128446
  },
  {
    "email": "signer2@email.com",
    "event": "signer_authentication_success",
    "created": 1672128452,
    "user_id": "83467d74be676ab81e5f7ebd8806786684b67284",
    "field_id": null,
    "unique_id": "ac6b28185c40406f1f4d9c184fe1760dfc99752f",
    "element_id": null,
    "ip_address": "3X.XX.XX.XX",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample Application",
    "json_attributes": {
      "phone_number_2fa": "+1XXX-XXXXXXX",
      "authentication_type": "phone_call"
    },
    "client_timestamp": 1672128452
  },
  {
    "email": "signer2@email.com",
    "event": "added_signature",
    "created": 1672128453,
    "user_id": "83467d74be676ab81e5f7ebd8806786684b67284",
    "field_id": "f5457d8f3498c9b7801a5ab4d948b80380b6c044",
    "unique_id": "0e3e36593e665409f1a470841e90259acfdd0898",
    "element_id": "10b86389bbec168eeb1f03336cfe16fe245700da",
    "ip_address": "3X.XX.XX.XX",
    "document_id": "bb5101d1b891f585ab0659378eb80831a5745ba2",
    "client_app_name": "Sample Application",
    "json_attributes": null,
    "client_timestamp": 1672128453
  }
]
```

### 400

- Wrong, expired, or missing token.
- User does not have access to this document.

**Example** (`Wrong token`)

```json
{
  "code": 1537,
  "error": "invalid_token"
}
```

**Example** (`No access to this document`)

```json
{
  "errors": [
    {
      "code": 65610,
      "message": "not readable"
    }
  ]
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X GET \
  "https://api.signnow.com/document/{document_id}/historyfull" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN"
```

---
*Full reference: https://docs.signnow.com/docs/document/operations/get-document-historyfull*