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

# List Template Versions

> List version snapshots for a template. Snapshots are created automatically before every update, enabling rollback if a PUT accidentally overwrites the schema.

## Path parameters

<ParamField path="id" type="string" required>
  Template ID (e.g., `tpl_7VQhP2tM9xA1kR8bN`).
</ParamField>

## Response

Returns an array of version snapshots, newest first (max 20).

```json theme={null}
{
  "data": [
    {
      "id": 12,
      "version_number": 3,
      "field_count": 42,
      "change_summary": "Pre-update snapshot",
      "created_at": "2026-05-02T15:30:00Z"
    },
    {
      "id": 11,
      "version_number": 2,
      "field_count": 42,
      "change_summary": "Pre-update snapshot",
      "created_at": "2026-04-28T10:00:00Z"
    }
  ]
}
```

| Field            | Type    | Description                                                                                                  |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| `id`             | integer | Version ID. Use this with the [Restore Version](/api-reference/templates/restore-template-version) endpoint. |
| `version_number` | integer | Sequential version number.                                                                                   |
| `field_count`    | integer | Number of fields in the schema at this version.                                                              |
| `change_summary` | string  | Description of what triggered the snapshot.                                                                  |
| `created_at`     | string  | ISO 8601 timestamp when the snapshot was created.                                                            |

## Example

```bash theme={null}
curl https://spitshake.io/api/templates/tpl_7VQhP2tM9xA1kR8bN/versions \
  -H "X-Auth-Token: YOUR_API_KEY"
```

<Note>
  Snapshots are created automatically before every `PUT /api/templates/:id` update and before submitter remapping. You don't need to create them manually.
</Note>