For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Docs

Filter events by type

Use a new query parameter to filter events by type

Tooling

  • API
  • Webhooks

Released

July 25, 2025

Status

Released

API version

Version 1

What's new?

We added a new event_type query parameter that you can use when working with the list events operation to return entities that match the specified event type.

GET /events?event_type=
event_type array[string]

Return events that match the specified event type. Use a comma-separated list to specify multiple event types

How it works

The new event_type query parameter lets you filter events by the kind of event that occurred. For example, you can use it to get only customer.created or customer.updated events if you're building a CRM integration.

It accepts a comma-separated list, so you can pass multiple event types and matching entities are returned.

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can list events using the API to start using the new query parameter.

Summary of changes

List events

Operation
  • + Added Field event_type

    Filter events by one or more event types.

Was this page helpful?