Paddle Billing
Search

List notification settings

Returns a paginated list of notification settings (notification destinations).

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: 200; Maximum: 200.

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.

activeboolean

Determine whether returned entities are active (true) or not (false).

traffic_sourcestring

Return entities that match the specified traffic source.

Response

dataarray[object]

Represents a notification destination.

idstring

Unique Paddle ID for this notification setting, prefixed with ntfset_.

descriptionstring

Short description for this notification destination. Shown in the Paddle web app.

typestring

Where notifications should be sent for this destination.

destinationstring

Webhook endpoint URL or email address.

activeboolean

Whether Paddle should try to deliver events to this notification destination.

api_versioninteger

API version that returned objects for events should conform to. Must be a valid version of the Paddle API. Cannot be a version older than your account default.

include_sensitive_fieldsboolean

Whether potentially sensitive fields should be sent to this notification destination.

subscribed_eventsarray[object]

Represents an event type.

endpoint_secret_keystring

Webhook destination secret key, prefixed with pdl_ntfset_. Used for signature verification.

traffic_sourcestring

Whether Paddle should deliver real platform events, simulation events or both to this notification destination.

metaobject

Information about this response.

request_idstring

Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

paginationobject

Keys used for working with paginated results.