---
title: "List upcoming events"
method: GET
path: "/webhooks/{webhookID}/events"
tags: ["Webhooks"]
---

# List upcoming events

`GET /webhooks/{webhookID}/events`

List the next 10 events that will be delivered to the specified webhook.

## Response `200`

List of events (the returned list is empty if none found)

- 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

## Other responses

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