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

# GET /api/im/incidents

`GET /api/im/incidents`

## Request

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

## Query parameters

- `status` string[]
- `severity` string[]
- `teamId` integer[]
- `customerId` integer[]
- `sourceId` integer[]
- `assignedUserId` string
- `onCall` '0' | '1' | 'true' | 'false'
- `unacknowledged` '0' | '1' | 'true' | 'false'
- `from` string, date-time
- `to` string, date-time
- `q` string
- `limit` integer
- `page` integer
- `cursor` string
- `asOf` string, date-time

## Response `200`

Successful response

- object
  - `items` object[], required
    - `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
    - `assignee` object, nullable, required: Primary assignee.
      - `userId` string, required
      - `name` string, nullable, required
      - `role` 'commander' | 'tech_lead' | 'comms' | 'assignee', required
      - `image` string, nullable, required
    - `createdByUser` object, nullable, required
      - `userId` string, required
      - `name` string, required
      - `image` string, nullable, required
    - `acknowledgedByUser` object, nullable, required
      - `userId` string, required
      - `name` string, required
      - `image` string, nullable, required
    - `resolvedByUser` object, nullable, required
      - `userId` string, required
      - `name` string, required
      - `image` string, nullable, required
    - `lastAlertAt` string, date-time, nullable, required
    - `alertDuplicateCount` integer, required
    - `host` string, nullable, required: Host named by the newest alert.
  - `nextCursor` string, nullable, required
  - `total` integer: Page mode only.
  - `asOf` string, date-time: Page mode only.

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API 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)