Skip to main content

Status Pages API

Create and manage public status pages that display uptime for your services.

Base URL: https://app.kamustatus.com/api

Status pages are publicly accessible at:

https://<slug>.kamustatus.com

You can also use a custom domain by pointing a CNAME to pages.kamustatus.com.

Features​

  • Monitor groups/categories -- organize monitors by setting the displayGroup field on each entry
  • 90-day uptime bars -- each monitor displays a visual bar of daily uptime for the last 90 days
  • Auto-refresh -- the page refreshes every 30 seconds when the browser tab is active
  • Progressive loading -- large monitor lists are loaded incrementally for fast initial render

List Status Pages​

curl https://app.kamustatus.com/api/status-pages \
  -H "x-api-key: km_your_api_key"

Get Status Page​

curl https://app.kamustatus.com/api/status-pages/:statusPageId \
  -H "x-api-key: km_your_api_key"

Create Status Page​

curl -X POST https://app.kamustatus.com/api/status-pages \
  -H "x-api-key: km_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Status",
    "slug": "acme",
    "monitorIds": ["mon_abc123", "mon_def456"]
  }'

The page will be available at https://acme.kamustatus.com.

Update Status Page​

curl -X PATCH https://app.kamustatus.com/api/status-pages/:statusPageId \
  -H "x-api-key: km_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Service Status",
    "monitorIds": ["mon_abc123", "mon_def456", "mon_ghi789"]
  }'

Delete Status Page​

curl -X DELETE https://app.kamustatus.com/api/status-pages/:statusPageId \
  -H "x-api-key: km_your_api_key"

Custom Domains​

You can serve a status page on your own domain (e.g. status.example.com) by creating a CNAME record.

Setup​

  1. Add a CNAME DNS record pointing your domain to pages.kamustatus.com:

    status.example.com  CNAME  pages.kamustatus.com

  2. Update the status page with your custom domain:

    curl -X PATCH https://app.kamustatus.com/api/status-pages/:statusPageId \
      -H "x-api-key: km_your_api_key" \
      -H "Content-Type: application/json" \
      -d '{
        "customDomain": "status.example.com"
      }'

  3. Kamustatus will automatically provision an SSL certificate for the custom domain.