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

# The Document object

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](/api-reference/envelopes/create-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](https://www.annature.com.au/contact) 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

<ParamField path="id" type="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.
</ParamField>

<ParamField path="name" type="string(500)">
  The file name of the document. This value is used as the download file name when retrieving the document from Annature.
</ParamField>

<ParamField path="pages" type="integer">
  The number of pages in the document.
</ParamField>

<ParamField path="original" type="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.
</ParamField>

<ParamField path="master" type="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.
</ParamField>

<ParamField path="created" type="string">
  The ISO 8601 timestamp for when the document was created.
</ParamField>

<RequestExample>
  ```bash Endpoints theme={null}
  GET /v1/documents
  GET /v1/documents/:id
  ```
</RequestExample>

<ResponseExample>
  ```json Document Object theme={null}
  {
    "id": "fcad499b03c6fc222bc66208317a18c9",
    "name": "Non disclosure agreement.pdf",
    "pages": 10,
    "original": "https://annature..",
    "master": "https://annature..",
    "created": "2019-12-17T05:30:00Z"
  }
  ```
</ResponseExample>