Get Webhook History

post

/2.0/alert/webhooks

Retrieve past events and alerts that Paddle has sent to webhooks on your account

Example Request

preparing...

Usage Notes

We strongly recommend that you utilize the query_head and query_tail to limit your search to no more than any 24-hour period when calling this API. This ensures that the API response time remains quick and consistent as the amount of events/alerts build up over time.
This endpoint is paginated, with a max 250 results per page. Use the page and alerts_per_age parameters to work with pagination.

Pagination is scheduled to be enforced on this endpoint from March 11, 2025. To learn more, see Pagination for Paddle Classic endpoints

Request

Body

vendor_id

integer

required

The vendor ID identifies your seller account. This can be found in Developer Tools > Authentication.

>= 1

vendor_auth_code

string

required

The vendor auth code is a private API key for authenticating API requests. This key should never be used in client side code or shared publicly. This can be found in Developer Tools > Authentication.

Match pattern:

[0-9a-f]+

page

integer

Paginate returned results.

>= 1

alerts_per_page

string

Number of webhook alerts to return per page. Returns 10 alerts by default.

>= 1 characters

Match pattern:

\d+

query_head

string<date-time>

The date and time (UTC - Coordinated Universal Time) at which the webhook occurred before (end date). In the format: YYYY-MM-DD HH:MM:SS

Match pattern:

[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1]) (2[0-3]|[01][0-9]):[0-5][0-9]:[0-5][0-9]

query_tail

string<date-time>

The date and time (UTC - Coordinated Universal Time) at which the webhook occurred after (start date). In the format: YYYY-MM-DD HH:MM:SS

Match pattern:

[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1]) (2[0-3]|[01][0-9]):[0-5][0-9]:[0-5][0-9]

Body