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

# List deployments

> Returns a template's deployments, newest first.

Lists the template's deployments in your API key's environment, including ones started from the dashboard. Each item is a [deployment](https://tapace.lk/docs/api-reference/deployments/get.md). Results are [paginated](https://tapace.lk/docs/pagination.md).

**id** `string` *required*

The template ID.

**limit** `integer` (default: 25)

Items per page, from 1 to 100.

**cursor** `string`

The `nextCursor` from the previous page.

```bash cURL theme={null}
curl https://api.tapace.lk/v1/templates/tmpl_Q4vN8xT2mLr7KpZs3Wd1/deployments \
  -H "Authorization: Bearer $TAPACE_API_KEY"
```

```json 200 theme={null}
{
  "object": "list",
  "data": [
    {
      "object": "deployment",
      "id": "depl_Hc7Ln2Xq9Vt4Rk8Pz3Wd",
      "templateId": "tmpl_Q4vN8xT2mLr7KpZs3Wd1",
      "targetRevision": 4,
      "status": "completed",
      "totals": { "total": 42, "processed": 42, "migrated": 41, "skipped": 1, "failed": 0 },
      "createdAt": "2026-10-18T10:00:00.000Z"
    }
  ],
  "hasMore": false,
  "nextCursor": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.