List a single incident

Returns a single incident by ID.

GET https://betteruptime.com/api/v2/incidents/{incident_id}

URL parameters

incident_id
required string

Headers

Authorization
required string
200

Response body

{
  "data": {
    "id": "25",
    "type": "incident",
    "attributes": {
      "name": "betteruptime homepage",
      "url": "https://betteruptime.com/",
      "http_method": "get",
      "cause": "Status 500",
      "incident_group_id": null,
      "started_at": "2020-03-09T17:37:56.662Z",
      "acknowledged_at": null,
      "acknowledged_by": null,
      "resolved_at": null,
      "resolved_by": null,
      "response_content": "\n404 Not Found\n\nNot Found\nThe requested URL /fail was not found on this server.\n",
      "response_options": "{}",
      "regions": [
        "us",
        "eu",
        "as",
        "au"
      ],
      "response_url": null,
      "screenshot_url": null,
      "escalation_policy_id": null,
      "call": true,
      "sms": true,
      "email": true,
      "push": true
    },
    "relationships": {
      "monitor": {
        "data": {
          "id": "2",
          "type": "monitor"
        }
      }
    }
  },
  "included": {
    "id": "2",
    "type": "monitor",
    "attributes": {
      "url": "https://betteruptime.com/",
      "pronounceable_name": "Better Uptime homepage",
      "monitor_type": "status",
      "monitor_group_id": null,
      "required_keyword": null,
      "verify_ssl": true,
      "check_frequency": 30,
      "call": false,
      "sms": false,
      "email": true,
      "push": true,
      "team_wait": 180,
      "http_method": "get",
      "request_timeout": 30,
      "recovery_period": 180,
      "request_body": "",
      "paused_at": null,
      "last_checked_at": "2020-12-11T08:15:34.000Z",
      "created_at": "2020-02-28T19:30:09.956Z",
      "updated_at": "2020-11-23T09:08:20.817Z"
    }
  }
}

Example cURL

curl --request GET \
  --url https://betteruptime.com/api/v2/incidents/123456789 \
  --header 'Authorization: Bearer YOUR_API_TOKEN'
Copied!