---
title: "List Notifications"
method: GET
path: "/v2/issuers/{organizationId}/notifications"
tags: ["notifications > Notifications"]
---

# List Notifications

`GET /v2/issuers/{organizationId}/notifications`

## Request

- Base URL: `https://rewards-api.getkard.com`
- URL: `https://rewards-api.getkard.com/v2/issuers/{organizationId}/notifications`
- Auth: HTTP bearer

Lists notifications previously dispatched to the issuer, most recent
first.

Results are filterable by event name, delivery status, and a
`created_at` time range.<br/>
<b>Required scopes:</b> `notifications:read`

## Path parameters

- `organizationId` string, required: Your issuer organization ID, provided by Kard

## Query parameters

- `page[after]` string
- `page[before]` string
- `page[size]` integer
- `filter[eventName]` 'earnedRewardApproved' | 'earnedRewardSettled' | 'earnedRewardRejected' | 'auditUpdate' | 'fileProcessingResult' | 'pushNotificationPlacementFile' | 'emailNotificationPlacementFile' | 'payoutReconciliationFile'
- `filter[status]` 'pending' | 'delivered' | 'delivery_failed': The delivery status of a notification.
- `filter[after]` string, date-time
- `filter[before]` string, date-time

## Response `200`

Response with status 200

- NotificationsNotificationsNotificationsListResponse
  - `data` NotificationsNotificationsNotificationUnion[], required
    - `type` 'notification', required: Discriminator value: notification
    - `id` string, required: The event ID of the notification; the value the replay endpoint consumes.
    - `attributes` NotificationsNotificationsNotificationAttributes, required
      - `eventId` string, required: The event ID of the notification.
      - `eventName` 'earnedRewardApproved' | 'earnedRewardSettled' | 'earnedRewardRejected' | 'auditUpdate' | 'fileProcessingResult' | 'pushNotificationPlacementFile' | 'emailNotificationPlacementFile' | 'payoutReconciliationFile', required
      - `transactionId` string: The network transaction id carried by the notification payload, matching `data.attributes.transactionId` on the delivered webhook. Present whenever the event is about a transaction; absent on events that are not.
      - `timestamp` string, date-time, required: When the notification was created.
      - `lastAttemptAt` string, date-time, required: When the most recent delivery attempt was recorded.
      - `status` 'pending' | 'delivered' | 'delivery_failed', required: The delivery status of a notification.
      - `attempts` integer, required: The number of delivery attempts recorded for this notification.
      - `statusCode` integer: The HTTP status code returned by the issuer's webhook on the last delivery attempt, when available.
      - `errorMessage` string: The error recorded on the last delivery attempt, when delivery failed.
  - `meta` NotificationsNotificationsPaginationMetadata, required: Response metadata.
    - `pageSize` integer, required: Number of items per page.
    - `hasNextPage` boolean, required: Indicates if there are more pages available after the current one.
    - `total` integer: Total number of records matching the query (for offset-based pagination).
    - `page` integer: Current page number (for offset-based pagination).
  - `links` CommonsLinks: Related links to the API call
    - `self` string, required
    - `prev` string
    - `next` string

## Other responses

- `400`: Error response with status 400
- `401`: Error response with status 401
- `429`: The issuer's traffic grew faster than its allowed rate, or the endpoint's own limit was reached. If the response includes a `Retry-After` header, wait that many seconds before retrying. See [Rate Limits](/2024-10-01/api/integration-guides/rate-limits).
- `500`: Error response with status 500

## Changes

- **2026-10-22** `4e87fc8b018b`: 1 info
  - added the non-success response with the status `429`
- **2026-10-19** `a664c5d23771`: 1 warning, 1 info
  - added the new `payoutReconciliationFile` enum value to the `data/items/oneOf[subschema #1]/attributes/eventName` response property for the response status `200`
  - added the new enum value `payoutReconciliationFile` to the `query` request parameter `filter[eventName]`

[Operation history](https://skmtc.dev/getkard/apis/getkard-2/changes/v2/issuers/:organizationId/notifications/get.md)

---

[API](https://skmtc.dev/getkard/apis/getkard-2.md) - [All operations](https://skmtc.dev/getkard/apis/getkard-2/llms.txt) - [OpenAPI document](https://skmtc.dev/getkard/apis/getkard-2/revisions/bd47764afa21?raw)