Skip to main content
The status endpoint returns a single aggregated snapshot of your organization’s monitoring health. Rather than paginating through every monitor, you get counts by health category and a single overall value that tells you whether your infrastructure is fully operational, degraded, or in an active incident. This makes it easy to integrate Overwatch data into a public status page, a Slack bot, or an internal ops dashboard.

​
Get status

GET /api/v1/status
Returns health counts across all monitors in your organization plus an overall rollup status.

​
Response

{
  "data": {
    "total": 24,
    "healthy": 21,
    "warning": 2,
    "down": 1,
    "overall": "incident"
  }
}
​
data.total
number
Total number of monitors in your organization, regardless of their current status or enabled state.
​
data.healthy
number
Number of monitors with a healthy status: up, ok, active, or present.
​
data.warning
number
Number of monitors with a warning status: degraded, expiring_soon, havent_heard, or changed.
​
data.down
number
Number of monitors in a non-healthy, non-warning state — effectively everything that is not healthy or warning. This includes down, failed, expired, missing, and no_cert.
​
data.overall
string
Rollup status for the organization. One of:
  • operational — all monitors are healthy or have no results yet.
  • degraded — at least one monitor is in a warning state and none are down.
  • incident — at least one monitor is in a down state.

​
Status logic

The overall field is determined by this priority order:
  1. If down > 0 → incident
  2. Else if warning > 0 → degraded
  3. Otherwise → operational

​
Example

curl https://overwatchapp.dev/api/v1/status \
  -H "Authorization: Bearer $API_KEY"
Response: 
{
  "data": {
    "total": 8,
    "healthy": 7,
    "warning": 1,
    "down": 0,
    "overall": "degraded"
  }
}

​
Use cases

Status page integration — Poll this endpoint every minute and display overall as a banner on your public status page. Map operational to green, degraded to yellow, and incident to red. Ops dashboard — Show the total, healthy, warning, and down counts as summary cards at the top of an internal dashboard to give on-call engineers an instant at-a-glance view. Alerting pipeline — Use overall in a webhook or CI step to gate deployments: if overall is incident, halt the rollout and page the on-call engineer.
Combine this endpoint with GET /api/v1/events?status=down to get both the high-level summary and the specific monitors that are currently failing.