---
title: "List webhook events"
method: GET
path: "/webhook_events"
tags: ["Webhooks"]
---

# List webhook events

`GET /webhook_events`

List all webhook events for your account. Events are ordered by their event_sequence in ascending order. Results are limited to the events created in last 90 days.

## Query parameters

- `starting_after` string
- `ending_before` string
- `limit` integer
- `category` 'customer' | 'external_account' | 'kyc_link' | 'liquidation_address' | 'liquidation_address.drain' | 'static_memo.activity' | 'transfer' | 'virtual_account' | 'virtual_account.activity' | 'bridge_wallet.activity' | 'shift4_base_deposit' | 'indexed_deposit' | 'card_account' | 'posted_card_account_transaction' | 'card_transaction' | 'card_withdrawal'

## Response `200`

List of webhook events

- object
  - `data` WebhookEvent[], required
    - `api_version` string, required
    - `event_id` string, required — A UUID that uniquely identifies a resource
    - `event_developer_id` string, required — The developer ID of the developer
    - `event_sequence` integer
    - `event_category` 'customer' | 'kyc_link' | 'liquidation_address.drain' | 'static_memo.activity' | 'transfer' | 'virtual_account.activity' | 'bridge_wallet.activity' | 'card_account' | 'card_transaction' | 'card_withdrawal' | 'posted_card_account_transaction' | 'external_account', required — The category of the webhook event
    - `event_type` 'created' | 'updated' | 'updated.status_transitioned' | 'deleted' | 'canceled', required — The values here will be prefixed with the event_category. For example, a customer created event will be `customer.created`
    - `event_object_id` string, required — A UUID that uniquely identifies a resource
    - `event_object_status` 'not_started' | 'incomplete' | 'active' | 'rejected' | 'under_review' | 'manual_review' | 'awaiting_ubo' | 'approved' | 'awaiting_funds' | 'funds_received' | 'payment_submitted' | 'payment_processed' | 'in_review' | 'canceled' | 'error' | 'returned' | 'refund_in_flight' | 'refund_failed' | 'refunded' | 'undeliverable'
    - `event_object` object, required — The object that was affected by the event
    - `event_object_changes` object, required — The changes that were made to the object
    - `event_created_at` string, date-time, required
  - `count` integer, required — Number of webhook events returned in this response

## Other responses

- `400` — Request containing missing or invalid parameters.
- `401` — Missing or invalid API key
- `500` — Unexpected error. User may try and send the request again.

---

[API](https://skmtc.net/bridge/apis/bridge-api.md) · [All operations](https://skmtc.net/bridge/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bridge/bridge-api/versions/570998bde3b5/schema)