Incident Notification Log

See which alerts were sent for an incident (session authentication only)

Overview

Lists the notification deliveries for an incident, with status and retry information.

GET /api/incidents/{id}/notifications

Authentication

Session only: Authorization: Bearer YOUR_JWT. API keys are rejected.

Query parameters

Parameter	Type	Default	Description
status	string		pending, delivered, failed or bounced.
channel	string		email, webhook or slack.
page	integer	1	Page number.
pageSize	integer	10	1-100.

Response

200 OK. data contains notifications (array, newest first) and pagination.

{
  "success": true,
  "data": {
    "notifications": [
      {
        "id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70",
        "incident_id": "3f6c1a52-9d1e-4b0a-8f7d-2a1b3c4d5e6f",
        "channel": "slack",
        "recipient": "#ops-alerts",
        "status": "failed",
        "delivered_at": null,
        "error_message": "channel_not_found",
        "retry_count": 3,
        "max_retries": 3,
        "last_retry_at": "2026-09-30T09:14:10.000Z",
        "created_at": "2026-09-30T09:12:06.000Z",
        "updated_at": "2026-09-30T09:14:10.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "total": 1,
      "totalPages": 1,
      "hasNext": false,
      "hasPrevious": false
    }
  }
}

Notification field	Type	Description
id, incident_id	UUID	Identifiers.
channel	string	Channel type.
recipient	string	Destination (address or channel name).
status	string	pending, delivered, failed or bounced.
delivered_at	string | null	ISO 8601 delivery time.
error_message	string | null	Failure reason.
retry_count, max_retries	number	Retry progress.
last_retry_at	string | null	Last retry time.
created_at, updated_at	string	ISO 8601 times.

Errors

Status	Code	Cause
401	MISSING_AUTH, INVALID_TOKEN	Missing or invalid session token.
404	RESOURCE_NOT_FOUND	No such incident in your project.

Example

cURL

curl "https://api.uptimeio.com/api/incidents/INCIDENT_ID/notifications?status=failed" \
  -H "Authorization: Bearer YOUR_JWT"