List Status Page Components
Returns every component of a status page, ordered by sort.
GET /api/status-pages/{id}/components
A component is one row on the status page: a monitor (sourceKind: monitor), a third-party provider from our dependency monitoring (sourceKind: dependency) or an entry you maintain by hand (sourceKind: manual). Components can sit in a group. The list holds every component of the page in one page of results, ordered by sort, then id. A page has at most 100 components.
The monitors the page includes automatically through includeCustomerMonitors are not components and do not appear here.
Access
Organization admin, editor and readonly. A customer-scoped user or API token only reaches pages of a customer in its scope; a page without a customer (customerId: null) answers it with 403 (forbidden). A page of another organization answers 404 (statusPageNotFound). :id takes the numeric id or the publicId of the status page.
Example (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"
curl -X GET "$BASE_URL/api/status-pages/1/components" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Response
200 OK
{
"items": [
{
"id": 7,
"publicId": "0b6f3c1e-8d2a-4f5b-9c7e-1a2b3c4d5e6f",
"statusPageId": 1,
"groupId": 3,
"sort": 0,
"name": "Main Site",
"description": null,
"showUptime": true,
"sourceKind": "monitor",
"monitorType": "http",
"monitorId": 101,
"manualStatus": null,
"dependencySlug": null,
"createdAt": "2026-10-27T09:00:00.000Z",
"updatedAt": "2026-10-27T09:00:00.000Z"
},
{
"id": 8,
"publicId": "5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a",
"statusPageId": 1,
"groupId": null,
"sort": 1,
"name": "Payment provider",
"description": "Card payments at checkout",
"showUptime": true,
"sourceKind": "manual",
"monitorType": null,
"monitorId": null,
"manualStatus": "operational",
"dependencySlug": null,
"createdAt": "2026-10-27T09:05:00.000Z",
"updatedAt": "2026-10-27T09:05:00.000Z"
}
],
"total": 2,
"page": 1,
"perPage": 2
}| Field | Description |
|---|---|
groupId | Numeric id of the group, or null when the component is not in a group. |
sourceKind | monitor, dependency or manual. |
monitorType, monitorId | The monitor of a monitor component; null for a manual one. monitorType is one of http, dns, icmp, smtp, ssh, tcp, ftp, imap_pop. |
manualStatus | State of a manual component: operational, degraded, partial_outage, major_outage or maintenance; null for the other kinds. |
dependencySlug | Provider slug of a dependency component (GET /api/public/dependencies); null for the other kinds. |
showUptime | Whether the component shows its availability bar on the page. |
Common errors
400 Bad Request(invalidIdentifier) when an id in the path is neither a number nor a UUID401 Unauthorizedwhen you are not logged in403 Forbidden(forbidden) when your role may not do this, or for a customer-scoped caller on a page without a customer or of another customer403 Forbidden(statusPagesModuleDisabled) when the status pages module is not activated404 Not Found(statusPageNotFound) when the status page does not exist or belongs to another organization