Retrieve a website's uptime

GET

https://api.modulards.com/api/public/v1/sites/:site/uptime

Returns one website’s uptime summary: whether it is monitored and switched on, its current status and since when, its last ping, and its availability over the last day, week and month (the percentage of successful pings and how many pings that covers).

A website without Uptime Monitor settings answers configured: false with everything else null. A paused monitor reports status: "unknown" but keeps its historical last ping and availability. A window with no pings reports percentage: null, never a made-up 100.

This read is heavier than “Retrieve a website”: fetch it for the website you are inspecting, not in a loop over your whole website list.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Path parameters

sitestringRequired

Response

200 - Uptime summary

jsonapiobjectOptional

metaobjectOptional