Account2

Addresses4

Adjustments3

API root1

Businesses4

Checkout domains4

Client tokens4

Countries1

Currencies1

Customer portals1

Customers6

Discount groups4

Discounts4

Event types1

Events1

IP addresses1

Metrics9

Notification logs1

Notification settings5

Notifications3

Payment methods3

Prices4

Pricing preview1

Products4

Reports4

Settings18

Simulation run events3

Simulation runs3

Simulation types1

Simulations4

Subscription history1

Subscriptions11

Transactions7

Verifications2

Webhooks

Addresses3

Adjustments2

API keys6

Businesses3

Client tokens3

Customers3

Discount groups2

Discounts3

Payment methods2

Payouts2

Prices3

Products3

Reports2

Subscriptions9

Transactions10

Notifications

List notifications

Changed on Jul 9, 2026

Returns a paginated list of notifications created in the last 90 days. Use the query parameters to page through results.

Notifications older than 90 days aren't retained.

get/notifications

Request

Base URL
https://sandbox-api.paddle.com
Auth
HTTP bearer

Query parameters

afterstring

Return entities after the specified Paddle ID when working with paginated endpoints. Used in the meta.pagination.next URL in responses for list operations.

per_pageinteger

Set how many entities are returned per page. Paddle returns the maximum number of results if a number greater than the maximum is requested. Check meta.pagination.per_page in the response to see how many were returned.

Default: 50; Maximum: 200.

notification_setting_idstring[]

Return entities related to the specified notification destination. Use a comma-separated list to specify multiple notification destination IDs.

order_bystring

Order returned entities by the specified field and direction ([ASC] or [DESC]). For example, ?order_by=id[ASC].

Valid fields for ordering: id.

searchstring

Return entities that match a search query. Searches id and type fields.

statusNotificationStatusQueryEnum[]

Return entities that match the specified status. Use a comma-separated list to specify multiple status values.

filterstring

Return entities that contain the value specified. Pass a Paddle ID or email address that appears in the event payload, or part of one. Complete Paddle IDs and email addresses match exactly; partial values match as a prefix or substring, and must be at least three characters.

tostring

Return entities up to a specific time. Pass an RFC 3339 datetime string.

fromstring

Return entities from a specific time. Pass an RFC 3339 datetime string.

Headers

Skip-Countstring

Set to true to skip the count query on list operations. When set, meta.pagination.estimated_total returns -1 instead of an exact count.

Response

The request has succeeded.

Example response

{
  "data": [
    {
      "id": "ntf_01ghbkd0frb9k95cnhwd1bxpvk",
      "payload": {
        "event_id": "evt_01gks14ge726w50ch2tmaw2a1x",
        "occurred_at": "2024-10-12T07:20:50.52Z",
        "notification_id": "ntf_01ghbkd0frb9k95cnhwd1bxpvk"
      },
      "occurred_at": "2024-10-12T07:20:50.52Z",
      "delivered_at": "2024-10-12T07:20:50.52Z",
      "replayed_at": "2024-10-12T07:20:50.52Z",
      "last_attempt_at": "2024-10-12T07:20:50.52Z",
      "retry_at": "2024-10-12T07:20:50.52Z",
      "notification_setting_id": "ntfset_01gt21c5pdx9q1e4mh1xrsjjn6"
    }
  ],
  "meta": {
    "request_id": "b15ec92e-8688-40d4-a04d-f44cbec93355",
    "pagination": {
      "estimated_total": 999
    }
  }
}

Changes

Jul 9, 2026v1e1ac347eb3c5 Revision changes
- info
  added the new optional header request parameter Skip-Count
Feb 2, 2026v19ba8be0f2006 Revision changes
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the // response's property type changed from string to no type, and format from date-time to no format for status
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the // response's property type changed from string to no type for status
- breaking
  the response's property type changed from object to no type for status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- breaking
  removed the required property / from the response with the status
- warning
  removed the optional property / from the response with the status
- info
  added to the response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  added to the // response property allOf list for the response status
- info
  removed subschema #2 from the // response property allOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  added subschema #2 to the // response property anyOf list for the response status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  removed the address.created enum value from the // response property for the response status
- info
  removed the address.imported enum value from the // response property for the response status
- info
  removed the address.updated enum value from the // response property for the response status
- info
  removed the adjustment.created enum value from the // response property for the response status
- info
  removed the adjustment.updated enum value from the // response property for the response status
- info
  removed the api_key.created enum value from the // response property for the response status
- info
  removed the api_key.expired enum value from the // response property for the response status
- info
  removed the api_key.expiring enum value from the // response property for the response status
- info
  removed the api_key.revoked enum value from the // response property for the response status
- info
  removed the api_key.updated enum value from the // response property for the response status
- info
  removed the business.created enum value from the // response property for the response status
- info
  removed the business.imported enum value from the // response property for the response status
- info
  removed the business.updated enum value from the // response property for the response status
- info
  removed the customer.created enum value from the // response property for the response status
- info
  removed the customer.imported enum value from the // response property for the response status
- info
  removed the customer.updated enum value from the // response property for the response status
- info
  removed the delivered enum value from the // response property for the response status
- info
  removed the discount.created enum value from the // response property for the response status
- info
  removed the discount.imported enum value from the // response property for the response status
- info
  removed the discount.updated enum value from the // response property for the response status
- info
  removed the event enum value from the // response property for the response status
- info
  removed the failed enum value from the // response property for the response status
- info
  removed the needs_retry enum value from the // response property for the response status
- info
  removed the not_attempted enum value from the // response property for the response status
- info
  removed the payment_method.deleted enum value from the // response property for the response status
- info
  removed the payment_method.saved enum value from the // response property for the response status
- info
  removed the payout.created enum value from the // response property for the response status
- info
  removed the payout.paid enum value from the // response property for the response status
- info
  removed the price.created enum value from the // response property for the response status
- info
  removed the price.imported enum value from the // response property for the response status
- info
  removed the price.updated enum value from the // response property for the response status
- info
  removed the product.created enum value from the // response property for the response status
- info
  removed the product.imported enum value from the // response property for the response status
- info
  removed the product.updated enum value from the // response property for the response status
- info
  removed the replay enum value from the // response property for the response status
- info
  removed the report.created enum value from the // response property for the response status
- info
  removed the report.updated enum value from the // response property for the response status
- info
  removed the subscription.activated enum value from the // response property for the response status
- info
  removed the subscription.canceled enum value from the // response property for the response status
- info
  removed the subscription.created enum value from the // response property for the response status
- info
  removed the subscription.imported enum value from the // response property for the response status
- info
  removed the subscription.past_due enum value from the // response property for the response status
- info
  removed the subscription.paused enum value from the // response property for the response status
- info
  removed the subscription.resumed enum value from the // response property for the response status
- info
  removed the subscription.trialing enum value from the // response property for the response status
- info
  removed the subscription.updated enum value from the // response property for the response status
- info
  removed the transaction.billed enum value from the // response property for the response status
- info
  removed the transaction.canceled enum value from the // response property for the response status
- info
  removed the transaction.completed enum value from the // response property for the response status
- info
  removed the transaction.created enum value from the // response property for the response status
- info
  removed the transaction.paid enum value from the // response property for the response status
- info
  removed the transaction.past_due enum value from the // response property for the response status
- info
  removed the transaction.payment_failed enum value from the // response property for the response status
- info
  removed the transaction.ready enum value from the // response property for the response status
- info
  removed the transaction.revised enum value from the // response property for the response status
- info
  removed the transaction.updated enum value from the // response property for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  removed subschema #2 from the // response property oneOf list for the response status
- info
  the // response's property pattern ^ntf_[a-z\d]{26}$ was removed for the status
- info
  the // response's property pattern ^ntfset_[a-z\d]{26}$ was removed for the status

Operation history (7 revisions)