API reference
GET /monitors
GET /api/v1/monitors returns every site and price page on your OwlHound account, with status and uptime for 24 hours, 7 days and 30 days.
Request
GEThttps://owlhound.com/api/v1/monitors
Every monitor on your account, in the order they were added, each with its current status. Uptime monitors also carry their uptime for the last 24 hours, 7 days and 30 days, and their latest incident.
Key: Any key (read-only or full).
Example
curl -H "Authorization: Bearer $OWLHOUND_KEY" https://owlhound.com/api/v1/monitorsAnswer:
{"monitors": [
{
"id": 12,
"name": "My shop",
"url": "https://shop.example.com",
"kind": "uptime",
"status": "active",
"uptime_percent": {"24h": 100.0, "7d": 99.982, "30d": 99.951},
"last_incident": {"id": 341, "started": 1792574520.0, "ended": 1792575360.0, "cause": "HTTP 503"}
}
]}| Field | Meaning |
|---|---|
id | The monitor's number, used in the other endpoints. |
name | The name you gave it. |
url | The address being checked. |
kind | uptime or price. |
status | active, down, watch (a failed check waiting for the confirming round, or an address that can't be checked) or paused. |
uptime_percent | Uptime monitors only: percentages for 24h, 7d and 30d, from confirmed outages. null until there is data. |
last_incident | Uptime monitors only: the latest outage, or null. Times are Unix seconds; ended is null while it is still going on. |
Status codes
| Code | When |
|---|---|
401 | The key is missing, wrong or revoked. |
429 | More than 60 requests in a minute with this key. |
Other endpoints
Get one monitor · Add a monitor · Delete a monitor · List incidents. Start at the API reference for keys and limits.
Start watching your site in minutes
Free for up to 10 sites, no card, nothing to install. Read-only access you can revoke at any time — never passwords, never admin access.