Status / Get

Fetch one status page by guid, including layout and appearance settings.

Endpoint

Method POST
Url https://downdar.com/api/v1/status/get

Request

Key fields

guid key Status page id.
{ "guid": "550e8400-e29b-41d4-a716-446655440000" }

Response

Top level

ok Always true on success.
status_page Status page object. Fields below apply to status_page.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

status_page

guid Status page id.
name Page name.
title_url Optional link URL for the page title.
theme light or dark.
display_mode compact or detailed.
show_targets true to show monitor targets on the public page.
page_background_hex Page background color.
header_color_hex Header background color.
text_color_hex Body text color.
published draft or published.
noindex true to discourage search indexing.
public_url Public URL path for this page.
embed_origins Hostnames allowed to embed this page in an iframe.
layout Sections and monitors on the page.
monitor_count Monitors on this page.

layout

sections Ordered section list.
monitors Monitors shown on the page.

layout.sections[]

id Section id.
name Section name.
sort_order Display order.

layout.monitors[]

monitor_type http, ping, tcp, ssl, dns, or heartbeat.
guid Monitor id.
display_name Optional override label; empty uses the monitor name.
name Resolved label shown on the page.
section_id Section id, or null for the root list.
sort_order Display order.

rate_limit

tier Rate tier this endpoint counts against (1-5).
cost Units consumed by this request against the tier window.
timeframe Rolling limit window: second, minute, hour, or day.
limit Maximum units allowed in the timeframe for this tier on your plan.
used Units already used in the current window.
remaining Units left before this tier returns HTTP 429.
{ "ok": true, "status_page": { "guid": "550e8400-e29b-41d4-a716-446655440000", "name": "Production status", "title_url": "https://example.com", "theme": "dark", "display_mode": "compact", "show_targets": true, "page_background_hex": "#262626", "header_color_hex": "#1C1C1C", "text_color_hex": "#BBBBBB", "published": "published", "noindex": false, "public_url": "https://example.com/status/550e8400-e29b-41d4-a716-446655440000", "embed_origins": [], "layout": { "sections": [ { "id": 12, "name": "Core services", "sort_order": 0 } ], "monitors": [ { "monitor_type": "http", "guid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "display_name": "", "name": "API", "section_id": 12, "sort_order": 0 } ] }, "monitor_count": 1 }, "rate_limit": { "tier": 3, "cost": 1, "timeframe": "minute", "limit": 300, "used": 45, "remaining": 255 } }