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

# Get one DocumentTemplate

> Retrieve a single DocumentTemplate record by its Id.

A **DocumentTemplate** defines a reusable template for generating documents such as contracts, proposals, or invoices. Templates support HTML, Word, and binary output formats and can include dynamic merge fields populated from customer and business data.

## Authentication

<Note>
  This endpoint requires OAuth2 authentication. Include a valid bearer token in the `Authorization` header.
  The authenticated user must be a full unrestricted administrator or have the **`DocumentTemplate-Read`** role.
</Note>

## Path Parameters

<ParamField path="id" type="integer" required>
  The Id of the DocumentTemplate record to retrieve.
</ParamField>

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET \
    "https://spaces.nexudus.com/api/crm/documenttemplates/87654321" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://spaces.nexudus.com/api/crm/documenttemplates/87654321',
    {
      headers: {
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    }
  );

  const record = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://spaces.nexudus.com/api/crm/documenttemplates/87654321',
      headers={
          'Authorization': 'Bearer YOUR_TOKEN'
      }
  )

  record = response.json()
  ```
</CodeGroup>

## Response

### 200

<ResponseField name="BusinessId" type="integer">
  ID of the business linked to this record.
</ResponseField>

<ResponseField name="BusinessName" type="string">
  Display name of the linked business (read-only).
</ResponseField>

<ResponseField name="Name" type="string">
  The name value for this document template.
</ResponseField>

<ResponseField name="Document" type="string">
  The document value for this document template.
</ResponseField>

<ResponseField name="BinaryDocumentFileName" type="string">
  Current file name of the binary document (read-only; upload via the corresponding URL field).
</ResponseField>

<ResponseField name="NewBinaryDocumentUrl" type="string">
  URL of a new file to upload as the binary document.
</ResponseField>

<ResponseField name="ClearBinaryDocumentFile" type="boolean">
  Set to true to remove the current binary document file.
</ResponseField>

<ResponseField name="TemplateOutputFormat" type="integer">
  The template output format value for this document template. See `eDocumentTemplateFormat` enum values: `1` = Html, `2` = Word, `3` = Binary.
</ResponseField>

<ResponseField name="Id" type="integer">
  Unique record identifier.
</ResponseField>

<ResponseField name="UniqueId" type="string">
  UUID of the record.
</ResponseField>

<ResponseField name="CreatedOn" type="string">
  Date and time the record was created (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedOn" type="string">
  Date and time the record was last updated (ISO 8601).
</ResponseField>

<ResponseField name="UpdatedBy" type="string">
  Email of the user who last updated this record.
</ResponseField>

<ResponseField name="IsNew" type="boolean">
  Whether the record was recently created.
</ResponseField>

<ResponseField name="SystemId" type="string">
  External system identifier.
</ResponseField>

```json Example Response theme={null}
{
  "BusinessId": 0,
  "BusinessName": null,
  "Name": "",
  "Document": null,
  "BinaryDocumentFileName": null,
  "NewBinaryDocumentUrl": null,
  "ClearBinaryDocumentFile": null,
  "TemplateOutputFormat": 0,
  "Id": 87654321,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "CreatedOn": "2025-01-10T08:00:00Z",
  "UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "UpdatedBy": "admin@example.com",
  "IsNew": false,
  "SystemId": null,
  "ToStringText": "DocumentTemplate Example",
  "LocalizationDetails": null,
  "CustomFields": null
}
```