# List templates

List event templates for the organization with optional filters.

Source: https://statusdashboard.com/docs/api/event-management/templates/list

`GET /app/templates`

Returns org-scoped event templates. Requires the `templates` plan feature and `admin` or `event` role.

***

## Request
See [API Basics](/docs/api) for required headers.

### Query parameters
| Parameter   | Type   | Default                                  | Description                                                        |
| ----------- | ------ | ---------------------------------------- | ------------------------------------------------------------------ |
| `eventType` | string | —                                        | Filter: `"incident"`, `"maintenance"`, or `"informational"`.       |
| `q`         | string | —                                        | Case-insensitive search on `name` and `title`. Max 100 characters. |
| `sort`      | string | `updatedAt`                              | `"updatedAt"` or `"name"`.                                         |
| `order`     | string | `desc` for `updatedAt`, `asc` for `name` | `"asc"` or `"desc"`.                                               |
| `limit`     | number | `100`                                    | Max items returned. Min `1`, max `100`.                            |

***

## Sample request
```bash
curl "https://api.statusdashboard.com/app/templates?eventType=incident&limit=50" \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "templates": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Database outage playbook",
      "eventType": "incident",
      "title": "Database connectivity issues",
      "description": "We are investigating database connectivity problems.",
      "notifications": true,
      "createdAt": "2026-01-10T12:00:00.000Z",
      "updatedAt": "2026-04-01T08:00:00.000Z"
    }
  ],
  "limits": {
    "templates": 100
  }
}
```

***

## Response fields
| Field              | Type   | Description                                                                                                                                                                                                   |
| ------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `templates`        | array  | Matching templates for this request. Each item has the same shape as [Get template](/docs/api/event-management/templates/get#response-fields) (`template` object fields, without the outer `limits` wrapper). |
| `limits.templates` | number | Max templates for your organization.                                                                                                                                                                          |

Templates include playbook fields only (no components, status, timeline message, publish, or schedule times). Writable fields match [Create template](/docs/api/event-management/templates/create#request-body). See [Templates](/docs/events/templates).

***

## Error responses
| Status | When                                                |
| ------ | --------------------------------------------------- |
| `403`  | Templates feature not enabled or insufficient role. |