List Webhooks

Returns all webhooks registered by the authenticated user. The webhook secret is not included in the response - it is only returned once during creation.

GET/api/v1/webhooksRequires authentication

Request examples

curl https://merx.exchange/api/v1/webhooks \
  -H "Authorization: Bearer your_jwt_token"

Response

200List of webhooks

[
  {
    "id": "wh_abc123",
    "user_id": "usr_xyz",
    "url": "https://example.com/webhooks/merx",
    "events": ["order.filled", "order.failed"],
    "is_active": true,
    "created_at": "2026-03-29T12:00:00Z"
  }
]

Response fields

idstringUnique webhook identifier

user_idstringOwner user identifier

urlstringRegistered endpoint URL

eventsstring[]Subscribed event types

is_activebooleanWhether the webhook is active

created_atstringISO 8601 creation timestamp