# List webhook events **GET /api/v1/webhooks/events** Returns the active v1 webhook event catalog. Subscribe with the customer-facing `eventType` value, for example `deposit.completed`. ## Servers - https://api.staging.lumetrade.com: https://api.staging.lumetrade.com () ## Parameters ### Headers - **X-API-KEY** (string) Public API key issued from the Lumetrade API key management flow. - **X-API-SECRET** (string) API secret paired with the public API key. ## Responses ### 200 Webhook events returned successfully #### Body: application/json (array[object]) - **eventType** (string) Customer-facing event key used in subscription requests. - **resourceType** (string) Resource category for the event. - **event** (string) Event name within the resource category. - **displayName** (string) Human-readable event name. - **description** (string) Short description of when the event is emitted. ### 403 Authenticated API key is not allowed to perform this action #### Body: application/json (object) - **code** (integer(int32)) - **message** (string) - **httpStatus** (integer(int32)) - **requestId** (string) - **timestamp** (string(date-time)) - **errors** (array[object]) ### 429 Cloudflare API rate limit exceeded #### Body: application/json (object) - **error** (string) - **message** (string) ### 401 API key authentication failed #### Body: application/json (object) - **code** (integer(int32)) - **message** (string) - **httpStatus** (integer(int32)) - **requestId** (string) - **timestamp** (string(date-time)) - **errors** (array[object]) ### 400 Request validation failed #### Body: application/json (object) - **code** (integer(int32)) - **message** (string) - **httpStatus** (integer(int32)) - **requestId** (string) - **timestamp** (string(date-time)) - **errors** (array[object]) ### 500 Unexpected server error #### Body: application/json (object) - **code** (integer(int32)) - **message** (string) - **httpStatus** (integer(int32)) - **requestId** (string) - **timestamp** (string(date-time)) - **errors** (array[object]) [Powered by Bump.sh](https://bump.sh)