---
title: "Get an incident by ID"
method: GET
path: "/api/public/v1/incident/search/{incidentId}"
tags: ["IncidentResourceSearch"]
---

# Get an incident by ID

`GET /api/public/v1/incident/search/{incidentId}`

## Request

- Base URL: `https://allquiet.app` (the document declares no server; this is the origin it was published from)
- URL: `https://allquiet.app/api/public/v1/incident/search/{incidentId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/allquiet/apis/all-quiet-public-api/docs/api/public/v1/incident/search/:incidentId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single incident the caller is authorized to view. Returns 404 when the incident does not exist or is outside the key's allowed teams. Voicemail download attributes include voiceMail.downloadUrl (retrieve the audio with this API key) and voiceMail.privateDownloadUrl (signed-in web app). Send If-None-Match with the ETag from a previous response to receive 304 Not Modified when the incident has not changed.

**Required API key permissions**

- **Scope:** `incidents:get`
- **Accepted key types:** organization API key (org-wide), organization API key (team-scoped), personal access token (org-wide), personal access token (team-scoped)
- **Access:** Access is checked against the specific resource (team or organization reachability).

## Path parameters

- `incidentId` string, uuid, required

## Headers

- `If-None-Match` string
- `If-Modified-Since` string

## Response `200`

OK

- AllQuietApiPublicIncidentsIncidentResource
  - `id` string, uuid, required
  - `title` string, nullable, required
  - `integration` AllQuietApiPublicIncidentsIncidentResourceEntityDto, required
    - `id` string, uuid, required
    - `displayName` string, nullable, required
  - `createdAt` string, date-time, nullable, required
  - `lastUpdatedAt` string, date-time, required
  - `attributes` AllQuietApiPublicIncidentsIncidentResourceAttribute[], nullable, required
    - `name` string, nullable, required
    - `value` string, nullable, required
    - `isImage` boolean, required
    - `isGroupingKey` boolean, required
    - `hideInPreviews` boolean, required
    - `voiceMail` AllQuietApiPublicIncidentsIncidentResourceVoiceMail
      - `downloadUrl` string, nullable, required: API-key URL for the voicemail file. Requires incidents:get. Follow the redirect to download the audio.
      - `privateDownloadUrl` string, nullable, required: Signed-in web app URL for the voicemail file.
  - `events` AllQuietApiPublicIncidentsIncidentResourceEvent[], nullable, required
    - `severity` string, nullable, required
    - `status` string, nullable, required
    - `modification` AllQuietApiPublicIncidentsIncidentResourceModification, required
      - `timestamp` string, date-time, required
      - `intent` string, nullable, required
      - `user` AllQuietApiPublicIncidentsIncidentResourceUser, required
        - `id` string, uuid
        - `displayName` string, nullable, required
        - `avatarUrl` string, nullable, required
        - `email` string, nullable, required
      - `externalUser` AllQuietApiPublicIncidentsIncidentResourceUserExternal, required
        - `id` string, nullable, required
        - `displayName` string, nullable, required
        - `avatarUrl` string, nullable, required
        - `provider` string, nullable, required
    - `userAssignments` AllQuietApiPublicIncidentsIncidentResourceUser[], nullable, required
      - `id` string, uuid
      - `displayName` string, nullable, required
      - `avatarUrl` string, nullable, required
      - `email` string, nullable, required
    - `onCallUsers` AllQuietApiPublicIncidentsIncidentResourceUser[], nullable, required
      - `id` string, uuid
      - `displayName` string, nullable, required
      - `avatarUrl` string, nullable, required
      - `email` string, nullable, required
    - `message` string, nullable, required
    - `messageIsPublic` boolean, nullable, required
    - `unattended` boolean, required
    - `teams` AllQuietApiPublicIncidentsIncidentResourceEntityDto[], nullable, required
      - `id` string, uuid, required
      - `displayName` string, nullable, required
    - `attributeChanges` AllQuietApiPublicIncidentsIncidentResourceAttributeChange[], nullable, required
      - `name` string, nullable, required
      - `newValue` string, nullable, required
      - `oldValue` string, nullable, required
  - `eventsTotalCount` integer, required
  - `services` AllQuietApiPublicIncidentsIncidentResourceEntityDto[], nullable, required
    - `id` string, uuid, required
    - `displayName` string, nullable, required
  - `sourceUser` AllQuietApiPublicIncidentsIncidentResourceUser, required
    - `id` string, uuid
    - `displayName` string, nullable, required
    - `avatarUrl` string, nullable, required
    - `email` string, nullable, required
  - `unattended` boolean, required
  - `isArchived` boolean, required
  - `onCallUsers` AllQuietApiPublicIncidentsIncidentResourceUser[], nullable, required
    - `id` string, uuid
    - `displayName` string, nullable, required
    - `avatarUrl` string, nullable, required
    - `email` string, nullable, required
  - `teams` AllQuietApiPublicIncidentsIncidentResourceEntityDto[], nullable, required
    - `id` string, uuid, required
    - `displayName` string, nullable, required
  - `snoozed` AllQuietApiPublicIncidentsIncidentResourceSnoozingProperties, required
    - `snoozedUntil` string, date-time, nullable, required
  - `subIncidents` AllQuietApiPublicIncidentsIncidentResourceSubIncident[], nullable, required
    - `id` string, uuid, required
    - `title` string, nullable, required
    - `events` AllQuietApiPublicIncidentsIncidentResourceSubIncidentEvent[], nullable, required
      - `severity` string, nullable, required
      - `status` string, nullable, required
      - `modification` AllQuietApiPublicIncidentsIncidentResourceModification, required
        - `timestamp` string, date-time, required
        - `intent` string, nullable, required
        - `user` AllQuietApiPublicIncidentsIncidentResourceUser, required
          - `id` string, uuid
          - `displayName` string, nullable, required
          - `avatarUrl` string, nullable, required
          - `email` string, nullable, required
        - `externalUser` AllQuietApiPublicIncidentsIncidentResourceUserExternal, required
          - `id` string, nullable, required
          - `displayName` string, nullable, required
          - `avatarUrl` string, nullable, required
          - `provider` string, nullable, required
      - `attributeChanges` AllQuietApiPublicIncidentsIncidentResourceAttributeChange[], nullable, required
        - `name` string, nullable, required
        - `newValue` string, nullable, required
        - `oldValue` string, nullable, required
    - `attributes` AllQuietApiPublicIncidentsIncidentResourceAttribute[], nullable, required
      - `name` string, nullable, required
      - `value` string, nullable, required
      - `isImage` boolean, required
      - `isGroupingKey` boolean, required
      - `hideInPreviews` boolean, required
      - `voiceMail` AllQuietApiPublicIncidentsIncidentResourceVoiceMail
        - `downloadUrl` string, nullable, required: API-key URL for the voicemail file. Requires incidents:get. Follow the redirect to download the audio.
        - `privateDownloadUrl` string, nullable, required: Signed-in web app URL for the voicemail file.
    - `lastUpdatedAt` string, date-time, required
    - `createdAt` string, date-time, nullable, required
  - `allowedIntents` string[], nullable, required
  - `canDelete` boolean, nullable
  - `excludeFromUptimeCalculation` boolean
  - `statusPageStartOverride` string, date-time, nullable
  - `statusPageEndOverride` string, date-time, nullable

## Other responses

- `304`: Not modified. The resource is unchanged; response body is empty.
- `404`: Not Found

---

[API](https://skmtc.dev/allquiet/apis/all-quiet-public-api.md) - [All operations](https://skmtc.dev/allquiet/apis/all-quiet-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/allquiet/apis/all-quiet-public-api/revisions/915aa0b1de95?raw)