---
title: "List Status Page Templates"
description: "Lists the incident and update templates of your organization."
---

`GET /api/status-pages/templates`

A template pre-fills the form for a new public incident (`kind: incident`) or for an update on a running one (`kind: update`). It publishes nothing by itself; incidents are still created with [Create Manual Incident](/api/monitoring/create-manual-incident).

## Access

Organization `admin`, `editor` and `readonly`, also customer-scoped. Templates belong to the whole organization. A template of another organization answers `404` (`statusPageTemplateNotFound`). Path ids take the numeric id or the `publicId`.

## Query Parameters

- `kind` (optional): `incident` or `update`. Any other value answers `400` (`invalidRequestBody`).

## Example (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X GET "$BASE_URL/api/status-pages/templates?kind=incident" \
  -H "Authorization: Bearer $TOKEN"
```

## Response

`200 OK`, every template (at most 200), by name:

```json
{
  "items": [{
      "id": 4,
      "publicId": "3f6c2a1b-8d4e-4b7a-9c1d-2e3f4a5b6c7d",
      "kind": "incident",
      "name": "Payment provider down",
      "title": "Card payments failing",
      "body": "We are looking into failed card payments.",
      "updateStatus": "investigating",
      "severity": "major",
      "impact": "partial_outage",
      "statusPageIds": [2],
      "componentIds": [8],
      "createdAt": "2026-10-27T09:00:00.000Z",
      "updatedAt": "2026-10-27T09:00:00.000Z"
    }],
  "total": 1,
  "page": 1,
  "perPage": 1
}
```

## Common errors

- `400 Bad Request` (`invalidRequestBody`) when `kind` is not `incident` or `update`
- `401 Unauthorized` when you are not logged in
- `403 Forbidden` (`statusPagesModuleDisabled`) when the status pages module is not activated