---
title: "List all payment method events"
method: GET
path: "/payment_methods/events"
tags: ["payment_methods"]
---

# List all payment method events

`GET /payment_methods/events`

Retrieve an ordered and paginated list of all payment method events in the authenticated environment.

Payment method events track important changes to payment methods such as creation, retention, redaction, and other lifecycle events. This endpoint allows you to retrieve these events with optional filtering and pagination.

*Response Format*

The response format varies by event type:
- `AddPaymentMethod` events are returned as `transaction` objects with embedded payment method data
- All other events are returned as `payment_method_event` objects

## Query parameters

- `order` string
- `since_token` string
- `event_type` string
- `count` string
- `include_transactions` boolean

## Response `200`

successful

- PaymentMethodEventsResponse
  - `payment_method_events` PaymentMethodEvent[] — Root element
    - `token` string — The unique identifier for the payment method event
    - `request_id` string — The unique identifier for the request that triggered this event
    - `created_at` string — The time the event was created
    - `payment_method_key` string — The token of the payment method associated with this event
    - `event_type` string — The type of event that occurred, e.g., `UpdatePaymentMethod`, `RetainPaymentMethod`, `ReplacePaymentMethod`
    - `event_data` object — Additional data specific to the event type
    - `state` string — The resulting state of the event
    - `message` string — A human-readable string indicating the result

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/spreedly/apis/spreedly-api-v1.md) · [All operations](https://skmtc.dev/spreedly/apis/spreedly-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/spreedly/spreedly-api-v1/revisions/72ba4e23e65c/schema)