Monitors / List

List monitors for the authenticated account. Does not include status; use /monitors/status for that. Optionally filter by group_id and/or tag_id. When both are sent, only monitors that match both filters are returned.

Endpoint

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

Request

Body fields

group_id opt Positive integer group id. When set, only monitors in that group are returned.
tag_id opt Positive integer tag id. When set, only monitors with that tag are returned.
{ "group_id": 12, "tag_id": 4 }

Response

Top level

ok Always true on success.
monitors Array of monitor summary objects.
capacity Monitor quota for the account.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

monitors[]

guid Monitor id.
monitor_type http, ping, tcp, ssl, or dns.
name Monitor name.
target Display target for this monitor type.

capacity

limit Maximum monitors allowed on your plan.
used Monitors currently in use.
remaining Monitors you can still create.

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, "monitors": [ { "guid": "550e8400-e29b-41d4-a716-446655440000", "monitor_type": "http", "name": "Homepage", "target": "https://example.com/" }, { "guid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "monitor_type": "ping", "name": "API server", "target": "api.example.com" } ], "capacity": { "limit": 10, "used": 3, "remaining": 7 }, "rate_limit": { "tier": 2, "cost": 1, "timeframe": "minute", "limit": 120, "used": 73, "remaining": 47 } }