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

# List Templates

> Get all document templates that you have read access to

Get a list of all document templates available to your account. Templates are reusable document structures with placeholders that can be filled in to generate customized legal documents.

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://api.wordsmith.ai/api/v1/templates' \
  --header 'Authorization: Bearer YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.wordsmith.ai/api/v1/templates", {
    method: "GET",
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
      "Content-Type": "application/json",
    },
  });

  const templates = await response.json();
  console.log(templates);
  ```

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

  url = "https://api.wordsmith.ai/api/v1/templates"
  headers = {
      "Authorization": "Bearer YOUR_API_KEY",
      "Content-Type": "application/json"
  }

  response = requests.get(url, headers=headers)
  templates = response.json()
  print(templates)
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Employment Agreement Template",
      "description": "Standard employment agreement template with customizable terms and conditions"
    },
    {
      "id": "987fcdeb-51a2-43d1-9e8f-7b6c5a4d3e2f",
      "name": "NDA Template",
      "description": "Non-disclosure agreement template for protecting confidential information"
    },
    {
      "id": "abcdef12-3456-7890-abcd-ef1234567890",
      "name": "Service Agreement",
      "description": null
    }
  ]
  ```
</ResponseExample>

## Response Fields

<ResponseField name="id" type="string">
  The unique identifier for the template
</ResponseField>

<ResponseField name="name" type="string">
  The display name of the template
</ResponseField>

<ResponseField name="description" type="string | null">
  A description of the template's purpose and content. Can be null if no
  description is provided.
</ResponseField>

## Notes

* Only templates that you have read access to will be returned
* The list includes both your organization's custom templates and any global templates you have access to
* Templates contain placeholder fields that can be filled in to generate customized documents
* Each template supports various document formats including DOCX and Markdown