Skip to Content
Uptimeify Docs
Status pages

Get Status Page

Returns one status page by numeric id or publicId, in the same shape as an entry of List Status Pages.

GET /api/status-pages/{id}

Access

Same access and visibility as List Status Pages: a page outside your scope answers 404.

Example (cURL)

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

curl -X GET "$BASE_URL/api/status-pages/1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

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 and customerName are null for a page without a customer. Such a page is visible to organization-wide roles and API tokens only; a customer-scoped caller does not see it. includeCustomerMonitors says whether the customer's monitors appear automatically. The components of a page are read with List Status Page Components and List Status Page Component Groups.

canEdit (since 30 October 2026) says whether you may change this page and what hangs off it (settings, components, custom domain, subscribers, incidents, maintenance). Organization-wide callers: true with the role admin or editor. Customer-bound users and tokens (also with the role readonly): true for self_service pages, for managed pages only when the customer has canEditManaged. It is the same rule the write endpoints apply, see Who may change a status page.

ipAllowlist and audienceGroups (since 28 October 2026) carry the page's IP allowlist (as addr/prefix) and its audience groups (name, emailDomains, componentIds as numeric ids); both are [] when not set.

Compatibility: since 27 October 2026 customerId can be null in responses (a page of the whole organization, without a customer), together with customerPublicId and customerName where present. A client that assumes customerId is always a number must handle null.

Common errors

  • 400 Bad Request when the id is neither a number nor a UUID, or your account has no organization
  • 401 Unauthorized when you are not logged in
  • 403 Forbidden when your role may not read status pages
  • 404 Not Found (statusPageNotFound) when the page does not exist or is outside your scope

On this page