GET /v1/documents
GET /v1/documents/:id

{
  "id": "fcad499b03c6fc222bc66208317a18c9",
  "name": "Non disclosure agreement.pdf",
  "pages": 10,
  "original": "https://annature..",
  "master": "https://annature..",
  "created": "2019-12-17T05:30:00Z"
}
A document represents the content of an envelope in the form of a PDF. It includes metadata such as the file name and number of pages. Documents can only be created when creating an envelope, and each envelope must contain at least one document.

​
Original and master copies

Each document, like the envelope it belongs to, has two versions:
  • The original copy represents the document exactly as it was uploaded — before any fields (such as signatures or dates) were applied.
  • The master copy (also referred to as the “live copy”) reflects the most up-to-date version of the document, with any applied fields and completed actions.
The master copy is available only if the envelope has progressed beyond the created status. If the envelope is voided, download access to the document is disabled.

​
Document limits

Annature imposes the following limits on uploaded documents to ensure consistent performance and reliability:
  • Maximum size per document: 10mb (raw base64 input)
  • Maximum total size per envelope: 50mb (across all documents)
  • Maximum pages per document: 500
  • Maximum total pages per envelope: 500 (across all documents)
If a document exceeds any of these limits, the API will return an error when the envelope is created or the document is uploaded. Need to send larger files? Contact us to request a limit increase. Annature supports both PDF and Word documents. Word files (.doc or .docx) are automatically converted to PDF during upload.

​
Attributes

​
id
string
A user-defined identifier for the document.If not supplied, Annature will generate one automatically. Supplying your own ID is recommended, as it allows you to reference this document in future API requests without needing to store the generated ID from the response.
​
name
string(500)
The file name of the document. This value is used as the download file name when retrieving the document from Annature.
​
pages
integer
The number of pages in the document.
​
original
string
A temporary URL that can be used to download the original version of the document (before any fields were applied).Download links are valid for 60 minutes. After expiry, the endpoint will return a 403 Forbidden response.
​
master
string
A temporary URL that can be used to download the master version of the document.This value will be null if the associated envelope has a created status.Download links are valid for 60 minutes. After expiry, the endpoint will return a 403 Forbidden response.
​
created
string
The ISO 8601 timestamp for when the document was created.
GET /v1/documents
GET /v1/documents/:id

{
  "id": "fcad499b03c6fc222bc66208317a18c9",
  "name": "Non disclosure agreement.pdf",
  "pages": 10,
  "original": "https://annature..",
  "master": "https://annature..",
  "created": "2019-12-17T05:30:00Z"
}