API reference
GET /incidents
GET /api/v1/incidents returns recent confirmed outages across your OwlHound monitors, newest first, optionally for one monitor.
Request
GEThttps://owlhound.com/api/v1/incidents
Confirmed outages across your monitors, newest first.
Key: Any key (read-only or full).
| Parameter | Where | What |
|---|---|---|
monitor_id | query, optional | Only this monitor's incidents. |
limit | query, optional | How many, 1 to 100. Defaults to 50. |
Example
curl -H "Authorization: Bearer $OWLHOUND_KEY" "https://owlhound.com/api/v1/incidents?monitor_id=12&limit=10"Answer:
{"incidents": [
{"id": 341, "monitor_id": 12, "started": 1792574520.0, "ended": 1792575360.0, "ongoing": false, "cause": "HTTP 503"}
]}| Field | Meaning |
|---|---|
started, ended | Unix seconds. ended is null while the outage is still going on. |
ongoing | true while it is still going on. |
cause | What the confirming check saw, such as an HTTP status or a timeout. |
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
List monitors · Get one monitor · Add a monitor · Delete a monitor. 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.