−50%

50% off your first month on any paid plan · code WELCOME50 · until Nov 30

Start free →

Status Pages

Status Pages

Retrieve status page configuration and statistics through the API. Status pages are read-only via the API — all creation and configuration is done through the WatchCron dashboard.

Read-only API. Status pages are read-only through the API. To create or configure status pages, use the WatchCron dashboard.

List status pages

GET /api/v1/status-pages

Returns a list of all status pages in the project associated with your API key.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://watchcron.com/api/v1/status-pages"
$response = Http::withToken('YOUR_API_KEY')
    ->get('https://watchcron.com/api/v1/status-pages');

$statusPages = $response->json('data');
import requests

response = requests.get(
    "https://watchcron.com/api/v1/status-pages",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

status_pages = response.json()["data"]
const response = await fetch(
  "https://watchcron.com/api/v1/status-pages",
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);

const { data: statusPages } = await response.json();
req, _ := http.NewRequest("GET",
    "https://watchcron.com/api/v1/status-pages", nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Response 200 OK

JSON
{
  "data": [
    {
      "slug": "main-status",
      "title": "Company Status",
      "description": "Current status of all company services",
      "is_enabled": true,
      "url": "https://watchcron.com/status/main-status",
      "custom_domain": null,
      "monitors_count": 8,
      "subscribers_count": 24,
      "created_at": "2026-04-10T09:00:00Z",
      "updated_at": "2026-10-20T14:30:00Z"
    }
  ]
}

Status page object

Every status page response includes these fields:

FieldTypeDescription
slugstringUnique slug identifier. Used in URLs and API lookups.
titlestringDisplay title of the status page
descriptionstring|nullOptional description shown on the status page
is_enabledbooleanWhether the status page is publicly accessible
urlstringFull public URL of the status page
custom_domainstring|nullCustom domain if configured (e.g. status.example.com)
monitors_countintegerNumber of monitors displayed on the page
subscribers_countintegerNumber of subscribers receiving status updates
created_atstringISO 8601 timestamp
updated_atstringISO 8601 timestamp

Get a status page

GET /api/v1/status-pages/{slug}

Returns full details for a single status page, identified by its slug.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     "https://watchcron.com/api/v1/status-pages/main-status"
$slug = 'main-status';

$response = Http::withToken('YOUR_API_KEY')
    ->get("https://watchcron.com/api/v1/status-pages/{$slug}");

$statusPage = $response->json('data');
slug = "main-status"

response = requests.get(
    f"https://watchcron.com/api/v1/status-pages/{slug}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

status_page = response.json()["data"]
const slug = "main-status";

const response = await fetch(
  `https://watchcron.com/api/v1/status-pages/${slug}`,
  { headers: { "Authorization": "Bearer YOUR_API_KEY" } }
);

const { data: statusPage } = await response.json();
slug := "main-status"

req, _ := http.NewRequest("GET",
    "https://watchcron.com/api/v1/status-pages/"+slug, nil)
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")

resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

Response 200 OK

JSON
{
  "data": {
    "slug": "main-status",
    "title": "Company Status",
    "description": "Current status of all company services",
    "is_enabled": true,
    "url": "https://watchcron.com/status/main-status",
    "custom_domain": null,
    "monitors_count": 8,
    "subscribers_count": 24,
    "created_at": "2026-04-10T09:00:00Z",
    "updated_at": "2026-10-20T14:30:00Z"
  }
}

Returns the same status page object as shown in Status page object. Returns 404 if the slug does not exist or belongs to a different project.

Pricing Docs
Log in Start free →