Monitors / View

Status history for one monitor. Set bucket to minute, hour, or day to return buckets, incidents, and checks for that window only.

Endpoint

Method POST
Url https://downdar.com/api/v1/monitors/view

Request

Key fields

guid key Monitor id.
monitor_type key http, ping, tcp, ssl, or dns.
bucket key minute, hour, or day. Selects which bucket window to return.
{ "guid": "550e8400-e29b-41d4-a716-446655440000", "monitor_type": "http", "bucket": "minute" }

Response

Fields

ok Always true on success.
guid Monitor id.
monitor_type http, ping, tcp, ssl, or dns.
bucket minute, hour, or day. Echoes the bucket requested.
regions Per-region metrics for the requested bucket. One entry for default rotation; multiple when region_mode is selected.
regions[].region_id Region id, or null for default rotation.
regions[].buckets Bucket grid: ts, status (unknown, up, warn, down), avg_ms, check counts.
regions[].incidents Incidents in the window: guid, status, started_at, ended_at.
regions[].checks Recent checks in the window: status, checked_at, duration_ms, error_message.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

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, "guid": "550e8400-e29b-41d4-a716-446655440000", "monitor_type": "http", "bucket": "minute", "regions": [ { "region_id": null, "buckets": [ { "ts": 1735686000, "status": "up", "avg_ms": 118, "checks_total": 1, "checks_up": 1, "checks_warn": 0, "checks_down": 0 }, { "ts": 1735686060, "status": "up", "avg_ms": 121, "checks_total": 1, "checks_up": 1, "checks_warn": 0, "checks_down": 0 }, { "ts": 1735686120, "status": "warn", "avg_ms": 340, "checks_total": 1, "checks_up": 0, "checks_warn": 1, "checks_down": 0 }, { "ts": 1735686180, "status": "up", "avg_ms": 115, "checks_total": 1, "checks_up": 1, "checks_warn": 0, "checks_down": 0 }, { "ts": 1735686240, "status": "up", "avg_ms": 119, "checks_total": 1, "checks_up": 1, "checks_warn": 0, "checks_down": 0 }, { "ts": 1735686300, "status": "up", "avg_ms": 122, "checks_total": 1, "checks_up": 1, "checks_warn": 0, "checks_down": 0 }, "…" ], "incidents": [ { "guid": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "status": "down", "started_at": "2026-07-01 10:12:00", "ended_at": "2026-07-01 10:18:00" } ], "checks": [ { "status": "up", "checked_at": "2026-07-01 10:28:00", "duration_ms": 119, "error_message": "" }, "…" ] } ], "rate_limit": { "tier": 4, "cost": 1, "timeframe": "minute", "limit": 60, "used": 8, "remaining": 52 } }