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

# Get Incident Updates

> Read an incident's change history

## Overview

Returns the history of an incident: creation, status changes, severity changes, field updates and the notes added with [Add Incident Update](/api-reference/incidents/add-update), newest first. Team comments written through [Incident Comments](/api-reference/incidents/comments) are not included.

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

## Authentication

`X-API-Key: YOUR_API_KEY` or `Authorization: Bearer YOUR_JWT`. A read-only key is sufficient.

## Path parameters

| Parameter | Type | Description |
| - | - | - |
| `id` | UUID | Incident ID. |

## Example

```bash theme={null}
curl https://api.uptimeio.com/api/incidents/3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f/updates \
  -H "X-API-Key: YOUR_API_KEY"
```

## Response

`200 OK`. `data` is an array, newest first.

```json theme={null}
{
  "success": true,
  "data": [
    {
      "id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
      "incident_id": "3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f",
      "action": "acknowledged",
      "message": "Incident acknowledged",
      "old_value": "open",
      "new_value": "acknowledged",
      "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "user_email": "oncall@example.com",
      "user_name": "On Call",
      "created_at": "2026-09-30T09:15:00.000Z"
    }
  ]
}
```

| Field | Type | Description |
| - | - | - |
| `action` | string | `created`, `status_changed`, `severity_changed`, `acknowledged`, `resolved`, `closed`, `reopened`, `updated`, `assigned`, or `comment_added` (a note added with Add Incident Update). |
| `message` | string \| null | Note attached to the entry. |
| `old_value` / `new_value` | string \| null | Previous and new value where relevant. |
| `user_id`, `user_email`, `user_name` | string \| null | Who made the change; `null` for system actions. |
| `created_at` | string | ISO 8601 time. |

## Errors

| Status | Code | When |
| - | - | - |
| `400` | `VALIDATION_ERROR` | `id` is not a UUID. |
| `401` | `MISSING_AUTH`, `INVALID_API_KEY`, `INVALID_TOKEN` | Missing or invalid credentials. |
| `404` | `RESOURCE_NOT_FOUND` | No such incident in your project. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.