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

# List webhook subscriptions

`GET /v1/webhooks/`

List all webhook subscriptions for the authenticated account. Optionally filter by status or event type.

## Query parameters

- `status` 'active' | 'inactive', nullable — Filter by status (active/inactive)
- `event_type` string, nullable — Filter by subscribed event type

## Response `200`

Webhooks listed successfully

- ListWebhooksResponseDto — Response for listing webhook subscriptions.
  - `results` WebhookResponseDto[], required — List of matching webhook subscriptions.
    - `id` string, required — Unique identifier for the webhook subscription.
    - `url` string, required — HTTPS endpoint URL where notifications are delivered.
    - `name` string, nullable — Human-readable label for the subscription.
    - `event_type` string, required — The event type this webhook is subscribed to, in `category.*` format. Currently only `deed.*` is supported.
    - `region` string, required — Geographic region this webhook is scoped to, in `type:value` format. Currently only Texas and its counties are supported.
    - `status` string, required — Current status of the webhook. `active` webhooks receive event notifications; `inactive` webhooks are paused and do not receive deliveries.
    - `created_at` string, required — Timestamp when the webhook was created (ISO 8601).
    - `updated_at` string, required — Timestamp of the last modification (ISO 8601).

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.dev/whitepages/apis/whitepages-api-reference.md) · [All operations](https://skmtc.dev/whitepages/apis/whitepages-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whitepages/whitepages-api-reference/revisions/c27a0cd8718f/schema)