---
title: "Get Webhook V2"
method: GET
path: "/mortgage/v2/webhooks/{id}"
tags: ["Webhooks"]
---

# Get Webhook V2

`GET /mortgage/v2/webhooks/{id}`

## Request

- Base URL: `https://api.proof.com`
- URL: `https://api.proof.com/mortgage/v2/webhooks/{id}`
- Auth: API key in header `ApiKey`

## Path parameters

- `id` string, required

## Response `200`

Webhook retrieved

- WebhookV2Object: An object representing a Webhook V2.
  - `id` string, required: The ID of the Webhook V2 object.
  - `url` string, required: Proof will make a POST request to this URL for every subscribed event.
  - `header` string, nullable: A header value to pass through every request Proof makes back to your webhook URL. This can be required authentication to your system for security purposes. (E.g. "header": "X-Custom-Header:X-Custom-Key")
  - `headers` string[]: A list of header values to pass through every request Proof makes back to your webhook URL. This can be required authentication to your system for security purposes. (E.g. "headers": ["[X-Custom-Header]:[X-Custom-Key]"])
  - `enabled` boolean, required: A boolean value to indicate if the webhook is active.
  - `request_id_header_name` string: The name of the header that will contain the request ID for each webhook request. Defaults to X-Request-Id.
  - `request_id_header_value_template` string, nullable
  - `oauth` object
    - `enabled` boolean
    - `token_url` string, nullable
    - `client_id` string, nullable
  - `subscriptions` string[], required: An array containing the desired events that Proof should POST a webhook for. See our [Webhooks V2 guide](https://dev.proof.com/docs/webhooks-v2) for a list of valid subscriptions.

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/proof/apis/proof-real-estate-api-specification.md) - [All operations](https://skmtc.dev/proof/apis/proof-real-estate-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/proof/apis/proof-real-estate-api-specification/revisions/30d9780cb628?raw)