---
title: "Changes to List notifications"
method: GET
path: "/notifications"
---

# Changes to List notifications

`GET /notifications`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 7 of 19 revisions.

- **2026-07-09** (v1) `e1ac347eb3c5`: 1 info
- **2026-02-02** (v1) `9ba8be0f2006`: 11 breaking, 1 warning, 89 info
- **2025-05-27** (v1) `e57c515077cc`: 10 warning
- **2025-05-07** (v1) `aeb882657253`: 6 warning
- **2025-04-25** (v1) `c4b1322e66ca`: 1 breaking
- **2024-08-06** (v1) `968e505782d4`: 84 warning
- **2024-02-19** (v1) `a4a4068ff792`: 9 breaking, 1 warning, 3 info

## Changes

- **2026-07-09** (v1) `e1ac347eb3c5`: 1 info
  - added the new optional `header` request parameter `Skip-Count`
- **2026-02-02** (v1) `9ba8be0f2006`: 11 breaking, 1 warning, 89 info
  - the `data/items/id` response's property type changed from `string` to no type for status `200`
  - the `data/items/notification_setting_id` response's property type changed from `string` to no type for status `200`
  - the `data/items/occurred_at` response's property type changed from `string` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/origin` response's property type changed from `string` to no type for status `200`
  - the `data/items/status` response's property type changed from `string` to no type for status `200`
  - the `data/items/type` response's property type changed from `string` to no type for status `200`
  - the `error` response's property type changed from `object` to no type for status `default`
  - removed the required property `error/code` from the response with the `default` status
  - removed the required property `error/detail` from the response with the `default` status
  - removed the required property `error/documentation_url` from the response with the `default` status
  - removed the required property `error/type` from the response with the `default` status
  - removed the optional property `error/errors` from the response with the `default` status
  - added `#/components/schemas/ApiError` to the `error` response property `allOf` list for the response status `default`
  - added `#/components/schemas/EventTypeName` to the `data/items/type` response property `allOf` list for the response status `200`
  - added `#/components/schemas/NotificationId` to the `data/items/id` response property `allOf` list for the response status `200`
  - added `#/components/schemas/NotificationOrigin` to the `data/items/origin` response property `allOf` list for the response status `200`
  - added `#/components/schemas/NotificationPayload` to the `data/items/payload` response property `allOf` list for the response status `200`
  - added `#/components/schemas/NotificationSettingId` to the `data/items/notification_setting_id` response property `allOf` list for the response status `200`
  - added `#/components/schemas/NotificationStatus` to the `data/items/status` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Timestamp` to the `data/items/occurred_at` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/event, subschema #2` from the `data/items/payload` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Timestamp, subschema #2` to the `data/items/delivered_at` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Timestamp, subschema #2` to the `data/items/last_attempt_at` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Timestamp, subschema #2` to the `data/items/replayed_at` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Timestamp, subschema #2` to the `data/items/retry_at` response property `anyOf` list for the response status `200`
  - the response property `data/items/delivered_at` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/last_attempt_at` became required for the status `200`
  - the response property `data/items/notification_setting_id` became required for the status `200`
  - the response property `data/items/occurred_at` became required for the status `200`
  - the response property `data/items/origin` became required for the status `200`
  - the response property `data/items/payload` became required for the status `200`
  - the response property `data/items/replayed_at` became required for the status `200`
  - the response property `data/items/retry_at` became required for the status `200`
  - the response property `data/items/status` became required for the status `200`
  - the response property `data/items/times_attempted` became required for the status `200`
  - the response property `data/items/type` became required for the status `200`
  - the response property `error` became required for the status `default`
  - the response property `meta` became required for the status `default`
  - removed the `address.created` enum value from the `data/items/type` response property for the response status `200`
  - …61 more
- **2025-05-27** (v1) `e57c515077cc`: 10 warning
  - added the new `api_key.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `api_key.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `api_key.expired` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `api_key.expired` enum value to the `data/items/type` response property for the response status `200`
  - added the new `api_key.expiring` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `api_key.expiring` enum value to the `data/items/type` response property for the response status `200`
  - added the new `api_key.revoked` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `api_key.revoked` enum value to the `data/items/type` response property for the response status `200`
  - added the new `api_key.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `api_key.updated` enum value to the `data/items/type` response property for the response status `200`
- **2025-05-07** (v1) `aeb882657253`: 6 warning
  - added the new `payment_method.deleted` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `payment_method.deleted` enum value to the `data/items/type` response property for the response status `200`
  - added the new `payment_method.saved` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `payment_method.saved` enum value to the `data/items/type` response property for the response status `200`
  - added the new `transaction.revised` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `transaction.revised` enum value to the `data/items/type` response property for the response status `200`
- **2025-04-25** (v1) `c4b1322e66ca`: 1 breaking
  - the response property `meta/pagination/estimated_total` became optional for the status `200`
- **2024-08-06** (v1) `968e505782d4`: 84 warning
  - added the new `address.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `address.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `address.imported` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `address.imported` enum value to the `data/items/type` response property for the response status `200`
  - added the new `address.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `address.updated` enum value to the `data/items/type` response property for the response status `200`
  - added the new `adjustment.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `adjustment.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `adjustment.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `adjustment.updated` enum value to the `data/items/type` response property for the response status `200`
  - added the new `business.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `business.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `business.imported` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `business.imported` enum value to the `data/items/type` response property for the response status `200`
  - added the new `business.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `business.updated` enum value to the `data/items/type` response property for the response status `200`
  - added the new `customer.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `customer.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `customer.imported` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `customer.imported` enum value to the `data/items/type` response property for the response status `200`
  - added the new `customer.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `customer.updated` enum value to the `data/items/type` response property for the response status `200`
  - added the new `discount.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `discount.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `discount.imported` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `discount.imported` enum value to the `data/items/type` response property for the response status `200`
  - added the new `discount.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `discount.updated` enum value to the `data/items/type` response property for the response status `200`
  - added the new `payout.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `payout.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `payout.paid` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `payout.paid` enum value to the `data/items/type` response property for the response status `200`
  - added the new `price.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `price.created` enum value to the `data/items/type` response property for the response status `200`
  - added the new `price.imported` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `price.imported` enum value to the `data/items/type` response property for the response status `200`
  - added the new `price.updated` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `price.updated` enum value to the `data/items/type` response property for the response status `200`
  - added the new `product.created` enum value to the `data/items/payload/allOf[subschema #1: Event]/event_type` response property for the response status `200`
  - added the new `product.created` enum value to the `data/items/type` response property for the response status `200`
  - …44 more
- **2024-02-19** (v1) `a4a4068ff792`: 9 breaking, 1 warning, 3 info
  - for the `query` request parameter `per_page`, default value was changed from `10` to `50`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/delivered_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/last_attempt_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/replayed_at` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/timestamp, subschema #2` to the `data/items/retry_at` response property `oneOf` list for the response status `200`
  - the `data/items/delivered_at` response's property type changed from `null, string` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/last_attempt_at` response's property type changed from `null, string` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/replayed_at` response's property type changed from `null, string` to no type, and format from `date-time` to no format for status `200`
  - the `data/items/retry_at` response's property type changed from `null, string` to no type, and format from `date-time` to no format for status `200`
  - for the `query` request parameter `per_page`, the max was set to `200.00`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `500`
  - the `per_page` response's property default value `10` was removed for the status `200`

---

[Operation](https://skmtc.dev/paddlehq/apis/paddle-api/docs/notifications/get.md) - [API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [Page](https://skmtc.dev/paddlehq/apis/paddle-api/changes/notifications/get)