List

List all status pages for your organisation.

This endpoint requires a valid API key but no specific scopes. Use this to find status page IDs for use in other endpoints.

GET /v2/status_pages

List

cURL

curl --request GET \
  --url https://api.incident.io/v2/status_pages \
  --header 'Authorization: Bearer <token>'

200

{
  "pagination_meta": {
    "after": "01FCNDV6P870EA6S7TK1DSYDG0",
    "page_size": 25
  },
  "status_pages": [
    {
      "description": "This status page is our public status page.",
      "id": "01FCNDV6P870EA6S7TK1DSYDG0",
      "name": "Our public status page",
      "public_url": "https://statuspage.incident.io/our-public-status-page"
    }
  ]
}

Authorizations

Authorization · string · header · required

API key from your incident.io dashboard (Settings → API keys)

Query Parameters

page_size · integer<int64> · default: 25

Integer number of records to return

Required range: x <= 250

Example:

25

after · string

An record's ID. This endpoint will return a list of records after this ID in relation to the API response order.

Example:

"01FDAG4SAP5TYPT98WGR2N7W91"

Response

200 - application/json

OK response.

pagination_meta · object · required

Show child attributes

Example:

{
  "after": "01FCNDV6P870EA6S7TK1DSYDG0",
  "page_size": 25
}

status_pages · object[] · required

Show child attributes

Example:

[
  {
    "description": "This status page is our public status page.",
    "id": "01FCNDV6P870EA6S7TK1DSYDG0",
    "name": "Our public status page",
    "public_url": "https://statuspage.incident.io/our-public-status-page"
  }
]