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

# Verify before you render

> List templates and read a template's manifest with your project key, so you fail fast instead of hitting a 404 or invalid-data error at render time.

Before rendering, confirm the template exists and read its manifest so your `data` keys bind. Two
canonical, key-authenticated read endpoints make this a fast pre-flight check.

## List templates

[`GET /v1/templates`](/api-reference/list-templates) returns every template in your key's project
with its publish state — lightweight, no manifest.

```bash theme={null}
curl https://api.craftkit.dev/v1/templates \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
```

```json theme={null}
{
  "templates": [
    {
      "id": "…",
      "name": "Charter Handover",
      "slug": "charter-handover",
      "templateType": "document",
      "currentVersionNumber": 2,
      "published": true,
      "createdAt": "2026-05-01T09:00:00.000Z",
      "updatedAt": "2026-06-01T12:00:00.000Z"
    }
  ]
}
```

## Read one template's manifest

[`GET /v1/templates/:slug`](/api-reference/get-template) returns the template plus its published
**manifest** and an auto-generated **JSON Schema** you can use for client-side validation.

```bash theme={null}
curl https://api.craftkit.dev/v1/templates/charter-handover \
  -H "Authorization: Bearer $CRAFTKIT_API_KEY"
```

```json theme={null}
{
  "slug": "charter-handover",
  "templateType": "document",
  "published": true,
  "currentVersionNumber": 2,
  "manifest": {
    "variables": [
      { "key": "booking.code", "dataType": "text", "required": true },
      { "key": "handover.signedBy", "dataType": "text", "required": true }
    ],
    "loops": [
      { "key": "areas", "label": "Inspection areas",
        "itemFields": [
          { "key": "areaKey", "dataType": "text" },
          { "key": "condition", "dataType": "text" }
        ] }
    ]
  },
  "jsonSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "...": "..." }
}
```

## Distinguish "missing" from "unpublished"

| Response                                            | Meaning                                           |
| --------------------------------------------------- | ------------------------------------------------- |
| `404 template_not_found`                            | No template with that slug in this key's project. |
| `200` with `"published": false`, `"manifest": null` | Template exists but has no published version yet. |
| `200` with a `manifest`                             | Ready to render — match your `data` keys to it.   |

<Tip>
  Cache the manifest and treat it as a contract. If a render returns `invalid_input_data`, re-read
  the manifest — the published version may have changed which keys or types it expects.
</Tip>