---
title: "Get template fields"
method: GET
path: "/v1/templates/{template_id}/fields"
tags: ["Templates"]
---

# Get template fields

`GET /v1/templates/{template_id}/fields`

Get the dynamic fields for a template.

**Authentication:** API Key required (`x-api-key` header) or JWT token

**Usage:** This endpoint is designed for no-code tool integrations (Zapier, Make.com).
It returns an array of field definitions used to dynamically generate input forms.

**Response format:** Array of field objects with: `key`, `label`, `type`, `required`,
optional `helpText`, and optional `spec` (for array fields).

**Field types:**
- `string`: Text input
- `integer`: Integer number
- `number`: Decimal number
- `boolean`: True/False checkbox
- `array`: Array of items with nested `spec` defining item structure

**Array fields:** When a field is an array of objects, the response includes a `spec`
array defining the structure of each item (name, label, type for each nested field).

**No credits consumed:** This is a read-only endpoint.

**Rate Limits:** 60 requests/min (free), 120 requests/min (paid). Headers included in response.

## Path parameters

- `template_id` string, required — Template short ID (12 characters)

## Response `200`

List of template fields

- TemplateField[]
  - `key` string, required — Field key/identifier
  - `label` string, required — Human-readable label
  - `type` string — Field type: string, integer, number, boolean, array
  - `required` boolean — Whether the field is required
  - `helpText` string, nullable — Help text with example value
  - `spec` TemplateFieldSpec[], nullable — For array fields: spec defining the structure of each item
    - `name` string, required — Field name
    - `label` string, required — Field label
    - `type` string — Field type: text, number

## Other responses

- `403` — Invalid or missing API key
- `404` — Template not found
- `422` — Validation Error

---

[API](https://skmtc.net/pdftemplateapi/apis/templatefox-api.md) · [All operations](https://skmtc.net/pdftemplateapi/apis/templatefox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pdftemplateapi/templatefox-api/revisions/5673fc0d5fad/schema)