List Webhook Endpoints

GET 
/webhooks/endpoints

Lists the webhook endpoints for the authenticated Refersion user. Cursor-paginated. Some users may receive a 402 if their plan doesn't include webhook access. The user's webhook configuration is auto-provisioned on first call — no endpoints yet just means an empty list, not an error. Each row has the endpoint's id, url, subscribed topics, and isSubscribedToAllTopics (true means topics is empty but every event type is delivered).

Rate limit: 30 requests per minute per account, shared across all webhook endpoints. Exceeding it returns 429 with a Retry-After header.

Request

Responses

200

Webhook endpoints retrieved successfully

401

Authentication required

402

Billing plan does not include webhook access (merchant principals only)

403

Token type is neither merchant nor marketplace

422

Invalid pagination parameters

429

Rate limit exceeded (30 requests per minute per owner)

500

Internal server error