---
title: "Get document history"
method: GET
path: "/document/{document_id}/historyfull"
---

# Get document history

`GET /document/{document_id}/historyfull`

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/document/{document_id}/historyfull`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/document/:document_id/historyfull/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Response `200`

Returns the history of the document.

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

- object[]
  - `email` string: Email address of the user who performed the action.
  - `event` string: Name of the event, for example `created_document` or `signed_document`.
  - `origin` string: Origin of the event, for example `original`.
  - `created` integer: Unix timestamp of the event.
  - `user_id` string: ID of the user who performed the action. `null` for actions not performed by a user.
  - `field_id` string: ID of the field the action relates to. `null` if the action is not related to a field.
  - `unique_id` string: ID of the history event.
  - `element_id` string: ID of the element the action relates to. `null` if the action is not related to an element.
  - `ip_address` string: IP address the action was performed from.
  - `document_id` string: ID of the document.
  - `client_app_name` string: Name of the application the action was performed in.
  - `json_attributes` unknown
  - `client_timestamp` integer: Unix timestamp of the action on the client side. `null` if not available.

## Other responses

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

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)