⌘K
OverviewAuthenticationOutages APIGET List outagesGET Get outagePOST Create incidentPOST AcknowledgePOST UnacknowledgePOST ResolvePOST EscalateDEL Delete incident
GET/v2/outages

List outages

Returns a paginated list of outages for your project.

Request

Query Parameters
pagenumberoptional
Page number for pagination (0-indexed)
Default:0
statusenum<string>optional
Filter by outage status
Available options:
allongoingresolved
Default:all
typeenum<string>optional
Filter by outage type
Available options:
allmanualmonitor
Default:all

Response

Returns a paginated list of outages with metadata.

Response Objectapplication/json
outagesarray<object>
Array of outage objects
hasNextPageboolean
Whether more pages are available
totalnumber
Total number of outages matching the filters
ongoingCountnumber
Number of currently ongoing outages
pagenumber
Current page number
resultsPerPagenumber
Number of results per page
RequestcURL
curl https://api.hyperping.io/v2/outages \
  -H "Authorization: Bearer ${API_TOKEN}"
200 OKJSON
{
  "outages": [
    {
      "id": 12345,
      "uuid": "outage_abc123",
      "startDate": "2026-01-21T10:30:00.000Z",
      "endDate": null,
      "durationMs": 3600000,
      "statusCode": 500,
      "description": "Server returned 500",
      "isResolved": false,
      "detectedLocation": "paris",
      "confirmedLocations": "paris,london,frankfurt",
      "protocol": "http",
      "acknowledgedAt": "2026-01-21T10:35:00.000Z",
      "acknowledgedBy": {
        "uuid": "user_xyz",
        "email": "john@example.com",
        "name": "John Doe"
      },
      "monitor": {
        "uuid": "mon_abc123",
        "name": "Production API",
        "url": "https://api.example.com",
        "protocol": "http"
      },
      "escalationPolicy": {
        "uuid": "policy_xyz",
        "name": "On-Call DevOps",
        "alertedSteps": 2,
        "totalSteps": 3
      }
    }
  ],
  "hasNextPage": true,
  "total": 150,
  "ongoingCount": 3,
  "page": 0,
  "resultsPerPage": 20
}
← Outages APIGet an outage →