> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scaling.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Incident

> Returns a single incident including its full status history.

Retrieves a single incident by its ID. The response includes all incident fields plus a `statusHistory` array containing every status transition the incident has gone through, in chronological order.

<Note>
  `statusHistory` surfaces just the lifecycle transitions (`investigating` → `identified` → …). For the **full** timeline — including internal notes, public updates, and redacted entries — call [List Incident Updates](./updates-list).
</Note>

## Path parameters

<ParamField path="id" type="string" required>
  The UUID of the incident to retrieve.
</ParamField>

## Response

<ResponseField name="data" type="object" required>
  <Expandable title="properties" defaultOpen>
    <ResponseField name="id" type="string" required>
      Unique identifier for the incident (UUID).
    </ResponseField>

    <ResponseField name="orgId" type="string" required>
      The organization this incident belongs to.
    </ResponseField>

    <ResponseField name="title" type="string" required>
      Short title describing the incident.
    </ResponseField>

    <ResponseField name="severity" type="string" required>
      Severity level: `critical`, `high`, `medium`, or `low`.
    </ResponseField>

    <ResponseField name="status" type="string" required>
      Current lifecycle status: `investigating`, `identified`, `monitoring`, or `resolved`.
    </ResponseField>

    <ResponseField name="affectedComponents" type="array of object" required>
      Components affected by this incident. Each entry has `id` and `name`. Empty array if none.
    </ResponseField>

    <ResponseField name="createdAt" type="string" required>
      ISO 8601 timestamp of when the incident was created.
    </ResponseField>

    <ResponseField name="updatedAt" type="string" required>
      ISO 8601 timestamp of when the incident was last updated.
    </ResponseField>

    <ResponseField name="statusHistory" type="StatusHistoryEntry[]" required>
      Ordered list of all status transitions, from oldest to newest.

      <Expandable title="StatusHistoryEntry properties">
        <ResponseField name="id" type="string" required>
          Unique identifier for this history entry.
        </ResponseField>

        <ResponseField name="status" type="string" required>
          The status that was set at this point: `investigating`, `identified`, `monitoring`, or `resolved`.
        </ResponseField>

        <ResponseField name="changedAt" type="string" required>
          ISO 8601 timestamp of when this transition occurred.
        </ResponseField>

        <ResponseField name="resolutionNote" type="string | null" required>
          Optional note recorded at the time of the transition. Most commonly set when transitioning to `resolved`. `null` if no note was recorded.
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

## Error responses

| Status | Code             | Description                                                |
| ------ | ---------------- | ---------------------------------------------------------- |
| `401`  | `not_authorized` | Missing or invalid API key.                                |
| `404`  | `not_found`      | No incident with the given ID exists in your organization. |
| `500`  | `server_error`   | An unexpected error occurred on our side.                  |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url "https://api.scaling.cloud/v1/incidents/YOUR_INCIDENT_ID" \
    --header "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "orgId": "org_01HX4K9MNPQRST",
      "title": "Payment service elevated error rate",
      "severity": "critical",
      "status": "monitoring",
      "affectedComponents": [
        { "id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "name": "Payments API" }
      ],
      "createdAt": "2025-04-07T08:23:11.000Z",
      "updatedAt": "2025-04-07T10:41:05.000Z",
      "statusHistory": [
        {
          "id": "sh_01HX4KABCDE001",
          "status": "investigating",
          "changedAt": "2025-04-07T08:23:11.000Z",
          "resolutionNote": null
        },
        {
          "id": "sh_01HX4KABCDE002",
          "status": "identified",
          "changedAt": "2025-04-07T09:15:44.000Z",
          "resolutionNote": null
        },
        {
          "id": "sh_01HX4KABCDE003",
          "status": "monitoring",
          "changedAt": "2025-04-07T10:41:05.000Z",
          "resolutionNote": null
        }
      ]
    }
  }
  ```

  ```json 401 theme={null}
  {
    "statusCode": 401,
    "type": "not_authorized_error",
    "code": "not_authorized",
    "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
  }
  ```

  ```json 404 theme={null}
  {
    "statusCode": 404,
    "type": "invalid_request_error",
    "code": "not_found",
    "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
  }
  ```

  ```json 500 theme={null}
  {
    "statusCode": 500,
    "type": "invalid_error",
    "code": "server_error",
    "requestId": "d3e4f5a6-b7c8-9012-defa-bc1234567890"
  }
  ```
</ResponseExample>