Skip to main content
GET
/
api
/
v1
/
incidents
/
{id}
Get incident
curl --request GET \
  --url https://app.larm.dev/api/v1/incidents/{id}
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "API outage",
    "type": "incident",
    "status": "identified",
    "impact": "major",
    "auto_created": false,
    "started_at": "2026-03-28T12:00:00Z",
    "resolved_at": null,
    "updates": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440000",
        "status": "identified",
        "body": "Root cause found in database connection pool.",
        "posted_at": "2026-03-28T12:30:00Z",
        "posted_by": "user@example.com"
      },
      {
        "id": "660e8400-e29b-41d4-a716-446655440000",
        "status": "investigating",
        "body": "Investigating API errors.",
        "posted_at": "2026-03-28T12:00:00Z",
        "posted_by": "user@example.com"
      }
    ],
    "affected_components": [
      {
        "id": "880e8400-e29b-41d4-a716-446655440000",
        "name": "API",
        "status": "major_outage"
      }
    ],
    "inserted_at": "2026-03-28T12:00:00Z",
    "updated_at": "2026-03-28T12:30:00Z"
  }
}
Requires incidents:read permission.
​
id
string
required
Incident UUID
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "title": "API outage",
    "type": "incident",
    "status": "identified",
    "impact": "major",
    "auto_created": false,
    "started_at": "2026-03-28T12:00:00Z",
    "resolved_at": null,
    "updates": [
      {
        "id": "770e8400-e29b-41d4-a716-446655440000",
        "status": "identified",
        "body": "Root cause found in database connection pool.",
        "posted_at": "2026-03-28T12:30:00Z",
        "posted_by": "user@example.com"
      },
      {
        "id": "660e8400-e29b-41d4-a716-446655440000",
        "status": "investigating",
        "body": "Investigating API errors.",
        "posted_at": "2026-03-28T12:00:00Z",
        "posted_by": "user@example.com"
      }
    ],
    "affected_components": [
      {
        "id": "880e8400-e29b-41d4-a716-446655440000",
        "name": "API",
        "status": "major_outage"
      }
    ],
    "inserted_at": "2026-03-28T12:00:00Z",
    "updated_at": "2026-03-28T12:30:00Z"
  }
}