---
title: "List events for a payment method"
method: GET
path: "/payment_methods/{payment_method_token}/events"
tags: ["payment_methods"]
---

# List events for a payment method

`GET /payment_methods/{payment_method_token}/events`

Get a list of events for a specific payment method.

*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
- `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
- `404` — Not Found

---

[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)