---
title: "Retrieve notification logs"
method: GET
path: "/api/v1/notifications/logs"
tags: ["Notification Logs"]
---

# Retrieve notification logs

`GET /api/v1/notifications/logs`

Retrieve notification logs based on the provided filters. API key must have the `View Notification logs` permission.

## Query parameters

- `notificationRunIds` integer[]
- `notificationTypes` string[]
- `statuses` string[]
- `recipientTypes` string[]
- `recipientEmails` string[]
- `recipientEntityIds` integer[]
- `recipientChannels` string[]
- `mediums` string[]
- `ignoredReasons` string[]
- `failedReasons` string[]
- `fromDate` string, date-time
- `untilDate` string, date-time
- `pageSize` integer, required
- `page` integer, required
- `orderBy` 'ASC' | 'DESC'

## Response `200`

Successfully retrieved notification logs

- NotificationLogResponse
  - `logs` NotificationLog[], required
    - `dateCreated` string, date-time — The date and time that this notification was created.
    - `dateDelivered` string, date-time — The date and time that this notification was delivered.
    - `dateUpdated` string, date-time — The date and time that this notification was updated.
    - `errorMessage` string — An additional error message.
    - `failedReason` 'CHANNEL_NOT_FOUND' | 'MEMBER_EMAILS_NOT_FOUND' | 'MISSING_CONTENT' | 'CLIENT_ERROR' | 'BACKSTAGE_BASE_URL_MISSING' | 'NO_SEATS_LEFT' — The reason why this notification failed.
    - `id` integer, required — The unique identifier of the notification log.
    - `ignoredReason` 'USER_UNSUBSCRIBED' | 'WORKSPACE_DISABLED' | 'CHANNEL_DISABLED' | 'DUPLICATE' | 'CORTEX_EMPLOYEE' | 'NON_CORTEX_USERS_DISABLED' | 'UNSUPPORTED' — The reason why this notification was ignored.
    - `medium` 'SLACK' | 'MICROSOFT_TEAMS' | 'EMAIL' | 'WEBHOOK', required — The medium used to send the notification.
    - `recipientChannel` string — The channel in Slack or MS Teams that this notification was sent to.
    - `recipientEmail` string — The email address that this notification was sent to.
    - `recipientEntityId` integer — The unique identifier of the entity that this notification was sent to.
    - `recipientType` 'USER' | 'TEAM' | 'ENTITY', required — The type of the notification recipient.
    - `recipientUserId` integer — The unique identifier of the Cortex user that this notification was sent to.
    - `runId` integer, required — The unique identifier of the notification run that this log is associated with.
    - `status` 'READY' | 'IGNORED' | 'FAILED' | 'DELIVERED', required — The status of the notification log.
    - `type` 'INITIATIVE_CREATION' | 'INITIATIVE_CUSTOM_SCHEDULE' | 'INITIATIVE_N_DAYS_LEFT' | 'SERVICE_REEVALUATED' | 'WEEKLY_REPORT' | 'BROKEN_OPEN_API_SPEC' | 'ENTITLEMENT_EXPIRATION' | 'ONCALL_ASSISTANT' | 'ONBOARDING_MESSAGE' | 'NOTIFY_INVALID_INTEGRATION' | 'ONCALL_PERSON_CHANGED' | 'ONCALL_STARTS_IN_N_DAYS' | 'TEAM_MEMBER_INVITATION' | 'PENDING_RULE_EXEMPTION' | 'TOKEN_EXPIRES_IN_N_DAYS' | 'SCHEDULED_SCORECARD_RULE_CREATION' | 'SCORECARD_RULE_ACTIVATES_IN_N_DAYS' | 'WORKFLOW_STATUS_UPDATE' | 'WORKFLOW_APPROVAL_PENDING' | 'VERIFICATION_PERIOD_STARTED' | 'VERIFICATION_PERIOD_REMINDER' | 'AI_ASSISTANT_WELCOME_MESSAGE' | 'ENTITY_SCORE_DROPPED' | 'ONBOARDING_WIZARD_STATE_COMPLETED' | 'EXPORT_COMPLETED', required — The type of the notification.
  - `page` integer, required — Current page number, 0-indexed
  - `total` integer, required — Total number of results
  - `totalPages` integer, required — Total number of pages

## Other responses

- `403` — Forbidden
- `429` — The client has exceeded the rate limit by performing too many requests in a short period. Retry the request after a delay.

---

[API](https://skmtc.dev/cortex/apis/cortex-api.md) · [All operations](https://skmtc.dev/cortex/apis/cortex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cortex/cortex-api/revisions/141799a965b4/schema)