---
title: "List events"
method: GET
path: "/events"
tags: ["Events"]
---

# List events

`GET /events`

## Request

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

Returns a paginated list of events that have occurred in the last 90 days. Use the query parameters to page through results.

Events older than 90 days aren't retained.

This is sometimes referred to as "the event stream."

## Query parameters

- `after` string
- `per_page` integer
- `order_by` string
- `event_type` EventTypeName[]
- `filter` string
- `to` string
- `from` string

## Headers

- `Skip-Count` string

## Response `200`

The request has succeeded.

- object
  - `data` Event[], required
    - `event_id` string, required: Unique Paddle ID for this event, prefixed with `evt_`.
    - `event_type` 'address.created' | 'address.imported' | 'address.updated' | 'adjustment.created' | 'adjustment.updated' | 'api_key.created' | 'api_key.expired' | 'api_key.expiring' | 'api_key.revoked' | 'api_key.updated' | 'api_key_exposure.created' | 'business.created' | 'business.imported' | 'business.updated' | 'client_token.created' | 'client_token.revoked' | 'client_token.updated' | 'customer.created' | 'customer.imported' | 'customer.updated' | 'discount.created' | 'discount.imported' | 'discount.updated' | 'discount_group.created' | 'discount_group.updated' | 'payment_method.saved' | 'payment_method.deleted' | 'payout.created' | 'payout.paid' | 'price.created' | 'price.imported' | 'price.updated' | 'product.created' | 'product.imported' | 'product.updated' | 'report.created' | 'report.updated' | 'subscription.activated' | 'subscription.canceled' | 'subscription.created' | 'subscription.imported' | 'subscription.past_due' | 'subscription.paused' | 'subscription.resumed' | 'subscription.trialing' | 'subscription.updated' | 'transaction.billed' | 'transaction.canceled' | 'transaction.completed' | 'transaction.created' | 'transaction.paid' | 'transaction.past_due' | 'transaction.payment_failed' | 'transaction.ready' | 'transaction.revised' | 'transaction.updated', required: Type of event sent by Paddle, in the format `entity.event_type`.
    - `occurred_at` string, date-time, required: RFC 3339 datetime string.
    - `data` EventData, required: New or changed entity.
  - `meta` PaginatedMeta, required: Information about this response.
    - `request_id` string, required: Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.
    - `pagination` Pagination, required: Keys used for working with paginated results.
      - `per_page` integer, required: Number of entities per page for this response. May differ from the number requested if the requested number is greater than the maximum.
      - `next` string, uri, required: URL containing the query parameters of the original request, along with the `after` parameter that marks the starting point of the next page. Always returned, even if `has_more` is `false`.
      - `has_more` boolean, required: Whether this response has another page.
      - `estimated_total` integer: Estimated number of entities for this response. For datasets with 100,000 or fewer matches, returns the exact count. For datasets with more than 100,000 matches, returns `100001` to indicate that more than 100,000 entities match. Returns `-1` when counting is skipped or couldn't be calculated. Use `has_more` and `next` to page through all results rather than relying on `estimated_total` for an exact count.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-10-19** (v1) `4f35a8c6ea4d`: 3 info
  - added the new optional `query` request parameter `filter`
  - added the new optional `query` request parameter `from`
  - added the new optional `query` request parameter `to`
- **2026-07-09** (v1) `e1ac347eb3c5`: 1 info
  - added the new optional `header` request parameter `Skip-Count`
- **2026-02-02** (v1) `9ba8be0f2006`: 9 breaking, 1 warning, 63 info
  - the `data/items/data` response's property type changed from `object` to no type for status `200`
  - the `data/items/event_id` response's property type changed from `string` to no type for status `200`
  - the `data/items/event_type` 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`
  - …69 more
- **2025-05-27** (v1) `e57c515077cc`: 5 warning
  - added the new `api_key.created` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `api_key.expired` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `api_key.expiring` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `api_key.revoked` enum value to the `data/items/event_type` response property for the response status `200`
  - …1 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/events/get.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)