---
title: "Retrieve a single webhook endpoint"
method: GET
path: "/api/v1/webhook-endpoints/{endpoint_id}"
tags: ["Webhook endpoints"]
---

# Retrieve a single webhook endpoint

`GET /api/v1/webhook-endpoints/{endpoint_id}`

## Request

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

Fetch one endpoint by id. The signing secret comes back masked.

## Path parameters

- `endpoint_id` string, required: Id of the endpoint to read, as returned when it was created.

## Response `200`

Successful Response

- WebhookEndpointResponse: Endpoint metadata with the secret MASKED (`whsec_****<last4>`).
  - `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)