<Intro>

<EndpointHeader />

<Description>

Returns one webhook endpoint's configuration and current delivery `status`, including its URL and subscribed event types. The signing secret is never included; if you lost it, mint a new one with [Rotate webhook signing secret](/docs/api/reference/rotate-webhook-secret).

</Description>

</Intro>

<Payload kind="response">

<Field name="id" type="string" required>

<Description>

Unique identifier for the endpoint (`whk_` prefix). Accepted as `webhook_id` by every `/v1/webhooks/{webhook_id}` operation.

</Description>

</Field>

<Field name="url" type="string" required>

<Description>

HTTPS URL Bird delivers this endpoint's events to.

</Description>

</Field>

<Field name="description" type="string">

<Description>

Human-readable label for the endpoint.

</Description>

</Field>

<Field name="events" type="array of string" required>

<Description>

Event types this endpoint is subscribed to; only matching events are delivered. Change the set with [Update a webhook endpoint](/docs/api/reference/update-webhook).

</Description>

</Field>

<Field name="status" type="string" required>

<Description>

Delivery state of the endpoint.

- `active`: the initial state; events are being delivered normally.
- `degraded`: recent deliveries are failing. Bird keeps delivering and retrying,
  and the endpoint returns to `active` automatically once deliveries succeed
  again.
- `paused`: all delivery is stopped, either because an update set `status` to
  `paused` or automatically after sustained delivery failures. A paused endpoint
  never resumes on its own: re-enable it with
  [Update a webhook endpoint](/docs/api/reference/update-webhook), then recover
  the missed events with
  [Replay missed events](/docs/api/reference/create-webhook-replay).

</Description>

<Description>

Possible values: `active`, `degraded`, `paused`

</Description>

</Field>

<Field name="created_at" type="string" required />

<Field name="updated_at" type="string" required />

</Payload>