---
title: "List fillable document templates and their fields"
method: GET
path: "/api/v1/documents/contracts/templates"
tags: ["contracts"]
---

# List fillable document templates and their fields

`GET /api/v1/documents/contracts/templates`

## Response `200`

Successful Response

- TemplateListResponse — List of fillable document templates.
  - `templates` TemplateDescriptor[], required
    - `type` 'employer' | 'employment' | 'service' | 'contractor' | 'default_contractor' | 'custom' | 'nda' | 'vendor' | 'milestone' | 'msa', required — Markdown contract template type.
    - `title` string, required
    - `description` string, required
    - `requiresDocument` boolean
    - `supportsContractGeneration` boolean
    - `supportsInvoicing` boolean
    - `fields` TemplateField[]
      - `key` string, required
      - `label` string, required
      - `type` 'string' | 'text' | 'number' | 'decimal' | 'date' | 'datetime' | 'boolean' | 'enum' | 'object' | 'array' — Structural type of a template field, so clients can render the right input. Composite types carry their shape: ``OBJECT`` populates :attr:`TemplateField.fields`, ``ARRAY`` populates :attr:`TemplateField.item`, and ``ENUM`` populates :attr:`TemplateField.options`.
      - `description` string, nullable
      - `required` boolean
      - `multiline` boolean
      - `source` 'user' | 'profile' | 'computed' | 'default' — Where a template field's value comes from. * ``USER`` — must be entered by the user. * ``PROFILE`` — taken from a party's profile when available; if the profile is incomplete or the party is not registered yet, it must be collected from the user. * ``COMPUTED`` — generated server-side (current date, reference, derived legal terms). * ``DEFAULT`` — filled with a boilerplate default; no input required.
      - `party` 'client' | 'contractor', nullable
      - `options` string[], nullable
      - `fields` TemplateField[], nullable
      - `item` TemplateField — recursive

---

[API](https://skmtc.net/hevn-inc/apis/hevn-api.md) · [All operations](https://skmtc.net/hevn-inc/apis/hevn-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hevn-inc/hevn-api/versions/e6301d6796bf/schema)