v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB
DigitalOcean-public.v2-new_Uptime

Retrieve Check State

To show information about an existing check's state, send a GET request to /v2/uptime/checks/$CHECK_ID/state.

get/v2/uptime/checks/{check_id}/state

Path parameters

check_idstring uuid required

A unique identifier for a check.

Response

The response will be a JSON object with a key called state. The value of this will be an object that contains the standard attributes associated with an uptime check's state.

Example response

{
  "state": {
    "regions": {
      "us_east": {
        "status": "UP",
        "status_changed_at": "2022-03-17T22:28:51Z",
        "thirty_day_uptime_percentage": 97.99
      },
      "eu_west": {
        "status": "UP",
        "status_changed_at": "2022-03-17T22:28:51Z",
        "thirty_day_uptime_percentage": 97.99
      }
    },
    "previous_outage": {
      "region": "us_east",
      "started_at": "2022-03-17T18:04:55Z",
      "ended_at": "2022-03-17T18:06:55Z",
      "duration_seconds": 120
    }
  }
}