---
title: "Get a webhook subscription"
method: GET
path: "/v1/webhooks/{webhook_id}"
tags: ["Webhooks"]
---

# Get a webhook subscription

`GET /v1/webhooks/{webhook_id}`

Retrieve a single webhook subscription by its ID.

## Path parameters

- `webhook_id` string, required

## Response `200`

Webhook retrieved successfully

- DetailResponseDtoWebhookResponseDto
  - `result` WebhookResponseDto, required — Webhook subscription response object.
    - `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
- `404` — Not Found
- `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)