---
title: "GET /api/im/incidents/{id}"
method: GET
path: "/api/im/incidents/{id}"
tags: ["Im"]
---

# GET /api/im/incidents/{id}

`GET /api/im/incidents/{id}`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/im/incidents/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Successful response

- object
  - `id` integer, required
  - `organizationId` integer, required
  - `teamId` integer, required
  - `title` string, required
  - `customerId` integer, nullable, required
  - `primarySourceId` integer, nullable, required
  - `severity` 'sev1' | 'sev2' | 'sev3' | 'sev4', required: sev1 is the most severe.
  - `severityManual` boolean, required
  - `status` 'triggered' | 'acknowledged' | 'investigating' | 'identified' | 'monitoring' | 'resolved' | 'merged', required
  - `mergedIntoId` integer, nullable, required
  - `escalationPolicyId` integer, nullable, required: Deprecated, always null.
  - `currentTier` integer, nullable, required
  - `escalationEpoch` integer, required
  - `escalationCycle` integer, required
  - `acknowledgedBy` string, nullable, required
  - `acknowledgedAt` string, date-time, nullable, required
  - `snoozedUntil` string, date-time, nullable, required
  - `autoResolve` boolean, required
  - `resolvedBy` string, nullable, required
  - `resolveNote` string, nullable, required
  - `statuspageUpdate` string, nullable, required
  - `createdBy` string, nullable, required
  - `sourceKind` 'alert' | 'manual' | 'api', required
  - `isTest` boolean, required
  - `triggeredAt` string, date-time, required
  - `resolvedAt` string, date-time, nullable, required
  - `statuspageRuleApplies` boolean, required: A status page rule of the team matches this severity.
  - `customerName` string, nullable, required
  - `customerPublicId` string, nullable, required
  - `monitoringIncidentPublicId` string, nullable, required: Uptimeify monitoring incident this one was bridged from.
  - `alerts` object[], required
    - `id` integer, required
    - `organizationId` integer, required
    - `sourceId` integer, required
    - `sourceType` string, nullable, required: Type of the alert source, e.g. uptimeify_monitoring, zabbix, api.
    - `dedupKey` string, required
    - `status` 'open' | 'suppressed' | 'resolved', required
    - `suppressedReason` string, nullable, required
    - `title` string, required
    - `severity` 'sev1' | 'sev2' | 'sev3' | 'sev4', required: sev1 is the most severe.
    - `host` string, nullable, required
    - `mappedFields` object, required: Normalized fields from the source mapping. The raw payload is never returned.
    - `duplicateCount` integer, required
    - `firstSeenAt` string, date-time, required
    - `resolvedAt` string, date-time, nullable, required
    - `incidentId` integer, nullable, required
  - `events` object[], required
    - `id` integer, required
    - `incidentId` integer, required
    - `at` string, date-time, required
    - `kind` string, required: alert_received, escalated_tier, notification_sent, acknowledged, status_changed, comment, ...; open-ended.
    - `actorUserId` string, nullable, required: null = system.
    - `actorName` string, nullable, required
    - `subjectName` string, nullable, required: Whom an assignment_changed event assigned.
    - `payload` object, nullable, required
  - `assignments` object[], required
    - `id` integer, required
    - `userId` string, required
    - `userName` string, nullable, required
    - `role` 'commander' | 'tech_lead' | 'comms' | 'assignee', required
    - `createdAt` string, date-time, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `404`: No such resource, or not visible to this token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)