---
title: "Retrieve a list of webhook endpoints"
method: GET
path: "/api/v1/webhook-endpoints"
tags: ["Webhook endpoints"]
---

# Retrieve a list of webhook endpoints

`GET /api/v1/webhook-endpoints`

## Request

- Base URL: `https://api.sudomock.com`
- URL: `https://api.sudomock.com/api/v1/webhook-endpoints`
- Auth: API key in header `x-api-key`

List every webhook endpoint on the account, with its URL, event types, and enabled state.

## Response `200`

Successful Response

- WebhookEndpointResponse[]
  - `id` string, required: Unique identifier for the webhook endpoint.
  - `url` string, required: The https URL that receives this endpoint's events.
  - `secret` string, required: Masked: whsec_****<last4>
  - `description` string, nullable: Your label for this endpoint.
  - `event_types` string[]: Event types this endpoint receives; an empty list means every event.
  - `enabled` boolean, required: Whether this endpoint currently receives events.
  - `event_naming` string: The event-name spelling this endpoint is pinned to: 'legacy' or 'current'.
  - `created_at` string, date-time, required: Time the endpoint was created.
  - `updated_at` string, date-time, nullable: Time the endpoint was last updated.

---

[API](https://skmtc.dev/sudomock/apis/sudomock-api.md) · [All operations](https://skmtc.dev/sudomock/apis/sudomock-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sudomock/apis/sudomock-api/revisions/c1cc24006c60?raw)