---
title: "List webhook endpoints"
method: GET
path: "/v1/webhooks"
tags: ["Webhooks"]
---

# List webhook endpoints

`GET /v1/webhooks`

List the webhook endpoints registered under the tenant. Signing secrets are masked in this response — the full secret is only returned when you create an endpoint or rotate its secret. The response is a bare JSON array ordered by most recent creation time.

## Response `200`

A bare JSON array of webhook endpoint objects.

- object[]
  - `id` string, uuid — You receive the UUID for this webhook endpoint.
  - `label` string — You receive the endpoint label.
  - `url` string, uri — You receive the destination URL that receives POST deliveries.
  - `secret` string — You receive the masked signing secret (only the last 4 characters are shown).
  - `subscribed_events` string[] — You receive the event types this endpoint is subscribed to. An empty array means all event types are delivered.
  - `enabled` boolean — You receive `true` when the endpoint is active and receiving deliveries.
  - `created_at` string, date-time — You receive the timestamp when the endpoint was created.
  - `updated_at` string, date-time — You receive the timestamp when the endpoint was last updated.

---

[API](https://skmtc.net/didit-protocol/apis/didit-credentials-api.md) · [All operations](https://skmtc.net/didit-protocol/apis/didit-credentials-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/didit-protocol/didit-credentials-api/revisions/e4eddba66557/schema)