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

# List events

`GET /v1/events`

Lists webhook events for the merchant with cursor-based pagination. Events are retained for 30 days.

## Query parameters

- `limit` integer
- `cursor` string
- `event_type` 'payout.created' | 'payout.initiated' | 'payout.paid' | 'payout.failed' | 'return.initiated' | 'return.paid' | 'return.failed' | 'return.returned' | 'deposit.received' | 'conversion.created' | 'conversion.completed' | 'conversion.failed' | 'account_holder.active' | 'account_holder.closed' | 'ping.test'
- `created_at.gte` string, date-time
- `created_at.lte` string, date-time

## Response `200`

Paginated list of events

- ListEventsResponseDto
  - `data` object[], required
    - `id` string, uuid, required — Unique identifier of the event. Matches the envelope `id` delivered in the webhook payload and is stable across subscription fan-out and retries.
    - `type` 'event', required — Resource type discriminator.
    - `event_type` 'payout.created' | 'payout.initiated' | 'payout.paid' | 'payout.failed' | 'return.initiated' | 'return.paid' | 'return.failed' | 'return.returned' | 'deposit.received' | 'conversion.created' | 'conversion.completed' | 'conversion.failed' | 'account_holder.active' | 'account_holder.closed' | 'ping.test', required — Event type.
    - `api_version` string, required — API version the event payload was rendered at. Stable across retries and redeliveries, and mirrored in the webhook envelope `api_version` field.
    - `created_at` string, date-time, required — ISO 8601 UTC timestamp when the event was created.
    - `data` object, required — Event payload. Shape matches the resource schema for `event_type`.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Changes

- **2026-07-29** `e5198bf3cf7e` — 2 warning, 2 info
  - added the new `account_holder.active` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `account_holder.closed` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new enum value `account_holder.active` to the `query` request parameter `event_type`
  - added the new enum value `account_holder.closed` to the `query` request parameter `event_type`
- **2026-04-24** `75f9878ced37` — 1 info
  - added the required property `data/items/api_version` to the response with the `200` status
- **2026-04-23** `f04b2c330a67` — 4 warning, 4 info
  - added the new `conversion.completed` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `conversion.created` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `conversion.failed` enum value to the `data/items/event_type` response property for the response status `200`
  - added the new `ping.test` enum value to the `data/items/event_type` response property for the response status `200`
  - …4 more
- **2026-04-22** `7e26180bf667` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/augustus/apis/augustus-banking-api/changes/v1/events/get.md)

---

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