Skip to main content

Overview

Retrieve complete details about a specific status page incident including all updates and affected monitors. This endpoint provides the full incident history and context.

Authentication

All requests must include authentication via API Key:
  • API Key: X-API-Key: YOUR_API_KEY

Request

curl -X GET https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050 \
  -H "X-API-Key: YOUR_API_KEY"

Path Parameters

ParameterTypeDescription
projectIdUUIDThe ID of the project
statusPageIdUUIDThe ID of the status page
idUUIDThe ID of the incident

Response

Returns the complete incident details with all updates.
{
  "success": true,
  "data": {
    "incident": {
      "id": "990e8400-e29b-41d4-a716-446655440050",
      "status_page_id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "API Service Degradation",
      "message": "We are experiencing elevated response times on our API servers",
      "severity": "major",
      "status": "resolved",
      "affected_monitor_ids": [
        "770e8400-e29b-41d4-a716-446655440010",
        "770e8400-e29b-41d4-a716-446655440011"
      ],
      "created_at": "2024-12-26T11:00:00Z",
      "updated_at": "2024-12-26T13:30:00Z",
      "resolved_at": "2024-12-26T13:30:00Z",
      "affected_monitors": [
        {
          "id": "770e8400-e29b-41d4-a716-446655440010",
          "name": "API Server - US East",
          "type": "http",
          "status": "up"
        },
        {
          "id": "770e8400-e29b-41d4-a716-446655440011",
          "name": "API Server - EU West",
          "type": "http",
          "status": "up"
        }
      ],
      "updates": [
        {
          "id": "aa0e8400-e29b-41d4-a716-446655440100",
          "incident_id": "990e8400-e29b-41d4-a716-446655440050",
          "message": "Service fully restored. All API endpoints responding normally.",
          "status": "resolved",
          "created_at": "2024-12-26T13:30:00Z",
          "created_by": "system"
        },
        {
          "id": "aa0e8400-e29b-41d4-a716-446655440101",
          "incident_id": "990e8400-e29b-41d4-a716-446655440050",
          "message": "We have identified the issue - a misconfigured load balancer was causing routing delays. We are implementing the fix now.",
          "status": "identified",
          "created_at": "2024-12-26T12:15:00Z",
          "created_by": "user"
        },
        {
          "id": "aa0e8400-e29b-41d4-a716-446655440102",
          "incident_id": "990e8400-e29b-41d4-a716-446655440050",
          "message": "We are investigating elevated response times on our API servers. Thank you for your patience.",
          "status": "investigating",
          "created_at": "2024-12-26T11:00:00Z",
          "created_by": "user"
        }
      ]
    }
  }
}

Response Fields

Incident Object:
FieldTypeDescription
idUUIDUnique incident identifier
status_page_idUUIDStatus page ID
titlestringIncident title
messagestringIncident description
severitystringSeverity level
statusstringCurrent status
affected_monitor_idsUUID[]List of affected monitor IDs
created_attimestampCreation timestamp
updated_attimestampLast update timestamp
resolved_attimestamp | nullResolution timestamp
Affected Monitors Array:
FieldTypeDescription
idUUIDMonitor ID
namestringMonitor name
typestringMonitor type
statusstringCurrent status
Updates Array - Chronological incident updates (most recent first):
FieldTypeDescription
idUUIDUpdate ID
incident_idUUIDParent incident ID
messagestringUpdate message
statusstringStatus at time of update
created_attimestampUpdate timestamp
created_bystringUser ID or “system”

Status Codes

StatusDescription
200Successfully retrieved incident
401Unauthorized (missing or invalid token)
404Incident or status page not found

Examples

Get Complete Incident with History

curl -X GET https://api.uptimeio.com/api/projects/660e8400-e29b-41d4-a716-446655440001/status-pages/550e8400-e29b-41d4-a716-446655440000/incidents/990e8400-e29b-41d4-a716-446655440050 \
  -H "X-API-Key: YOUR_API_KEY"

Error Codes

Incident Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Incident not found"
  }
}

Status Page Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Status page not found"
  }
}

Unauthorized

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Authentication required"
  }
}