Statusseite abfragen
Gibt eine Statusseite per numerischer ID oder publicId zurück, in derselben Form wie ein Eintrag von „Statusseiten auflisten“.
GET /api/status-pages/{id}
Zugriff
Derselbe Zugriff und dieselbe Sichtbarkeit wie Statusseiten auflisten: Eine Seite außerhalb deines Bereichs antwortet 404.
Beispiel (cURL)
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"
curl -X GET "$BASE_URL/api/status-pages/1" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Antwort (Response)
200 OK
{
"id": 1,
"publicId": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
"organizationId": 10,
"customerId": 5,
"includeCustomerMonitors": true,
"managementType": "managed",
"canEdit": true,
"customerPublicId": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
"customerName": "Acme GmbH",
"name": "Acme Status",
"slug": "acme",
"description": null,
"visibility": "public",
"hasPassword": false,
"accessPasswordSetAt": null,
"isPublished": true,
"showRecentIncidents": true,
"showRecentMaintenance": true,
"subscriptionsEnabled": false,
"subscriptionDelayMinutes": 5,
"smsSubscriptionsEnabled": false,
"pushSubscriptionsEnabled": false,
"monitorUpdatesEnabled": true,
"designConfig": null,
"hiddenMonitors": [],
"ipAllowlist": [],
"audienceGroups": [],
"createdAt": "2026-06-01T08:00:00.000Z",
"updatedAt": "2026-06-01T08:00:00.000Z",
"customDomain": {
"id": 12,
"hostname": "status.acme.example",
"status": "active",
"verifiedAt": "2026-06-02T08:00:00.000Z",
"lastVerificationError": null,
"lastVerificationErrorAt": null,
"verificationToken": "uptimeify-verify-abc123"
}
}customerId, customerPublicId und customerName sind bei einer Seite ohne Kunde null. Eine solche Seite sehen nur organisationsweite Rollen und API-Token; ein kundengebundener Aufrufer sieht sie nicht. includeCustomerMonitors sagt, ob die Monitore des Kunden automatisch erscheinen. Die Komponenten einer Seite liest du mit Komponenten auflisten und Komponentengruppen auflisten.
canEdit (seit 30. Oktober 2026) sagt, ob du diese Seite und was an ihr hängt ändern darfst (Einstellungen, Komponenten, eigene Domain, Abonnenten, Vorfälle, Wartungen). Organisationsweite Aufrufer: true mit der Rolle admin oder editor. Kundengebundene Nutzer und Tokens (auch mit der Rolle readonly): true für self_service-Seiten, für managed-Seiten nur, wenn der Kunde canEditManaged hat. Es ist dieselbe Regel, die die schreibenden Endpunkte anwenden, siehe Wer eine Statusseite ändern darf.
ipAllowlist und audienceGroups (seit 28. Oktober 2026) enthalten die IP-Freigabeliste der Seite (als addr/prefix) und ihre Zielgruppen (name, emailDomains, componentIds als numerische IDs); ohne Einstellung sind beide [].
Kompatibilität: Seit dem 27.10.2026 kann customerId in Antworten null sein (eine Seite der ganzen Organisation, ohne Kunde), ebenso customerPublicId und customerName, wo vorhanden. Ein Client, der annimmt, dass customerId immer eine Zahl ist, muss null behandeln.
Häufige Fehler
400 Bad Request, wenn die ID weder Zahl noch UUID ist oder dein Konto keiner Organisation angehört401 Unauthorized, wenn du nicht angemeldet bist403 Forbidden, wenn deine Rolle keine Statusseiten lesen darf404 Not Found(statusPageNotFound), wenn die Seite nicht existiert oder außerhalb deines Bereichs liegt