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:
| Field | Type | Description |
|---|---|---|
slug | string | Unique slug identifier. Used in URLs and API lookups. |
title | string | Display title of the status page |
description | string|null | Optional description shown on the status page |
is_enabled | boolean | Whether the status page is publicly accessible |
url | string | Full public URL of the status page |
custom_domain | string|null | Custom domain if configured (e.g. status.example.com) |
monitors_count | integer | Number of monitors displayed on the page |
subscribers_count | integer | Number of subscribers receiving status updates |
created_at | string | ISO 8601 timestamp |
updated_at | string | ISO 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.