---
title: "List webhooks"
method: GET
path: "/webhooks"
tags: ["webhooks"]
---

# List webhooks

`GET /webhooks`

Lists all webhooks associated to the Management API key, optionally filtered by status.

## Query parameters

- `status` 'enabled' | 'disabled'
- `environment` string
- `cursor` string
- `limit` number

## Headers

- `X-API-Version` string, required

## Response `200`

List of webhooks matching the given query.

- WebhooksPaginatedListResponseDtoV2
  - `data` WebhookEntityV1[], required
    - `id` string, required — Webhook ID.
    - `description` string, required — Description of the webhook.
    - `status` 'enabled' | 'disabled', required — Status of the webhook: 'enabled' or 'disabled'.
    - `verified` boolean, required — Indicates if the webhook endpoint has been verified.
    - `environment` object, required — Environment ID this webhook is associated with. Null if global.
    - `url` string, required — URL of the webhook endpoint. Must start with https://.
    - `legacy` boolean, required — True if webhook is legacy. See docs for more details.
    - `signing_key` string — The signing key for verifying webhook payloads. Will only be returned on creation. See docs for more details.
    - `basic_auth` object, nullable, required — Basic authentication credentials. Only applies to legacy webhooks.
    - `created_at` string, date-time, required — Timestamp of when the webhook was created.
    - `last_enabled_at` object, nullable — Timestamp of when the webhook was last enabled.
    - `last_disabled_at` object, nullable — Timestamp of when the webhook was last disabled.
  - `metadata` PaginationMetadataV2, required
    - `pagination` PaginationDataV2, required
      - `next_cursor` string, nullable, required — Cursor token to be used to get the next page of results.
      - `prev_cursor` string, nullable, required — Cursor token used to get the previous page of results.

## Other responses

- `400` — Error: Bad request.
- `401` — Unauthorized. API key is invalid.
- `403` — Forbidden. Insufficient permissions.
- `404` — Webhook does not exist.
- `422` — Error: Payload parameters are invalid.
- `429` — Error: API key has exceeded its rate limit.

---

[API](https://skmtc.net/fingerprint/apis/management-api.md) · [All operations](https://skmtc.net/fingerprint/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fingerprint/management-api/versions/b17eccec9d47/schema)