Introducing Webhooks — Get real-time property deed updates delivered to you. Learn more →
Whitepages
Webhooks

List webhook subscriptions

List webhook subscriptions with optional filtering.

GET
/v1/webhooks/

Authorization

ApiKeyAuth

x-api-key<token>

API key for authentication. Get your key from the Whitepages developer portal.

In: header

Query Parameters

status?Status|Status

Filter by status (active/inactive)

event_type?Event Type|Event Type

Filter by subscribed event type

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.whitepages.com/v1/webhooks/"
{
  "results": [
    {
      "id": "string",
      "url": "string",
      "name": "string",
      "event_type": "string",
      "region": "string",
      "status": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ]
}
{
  "error": {
    "code": 400,
    "message": "Bad Request",
    "long_message": "Invalid person ID format: 'sdf'. Person ID must start with 'P' followed by exactly 10 alphanumeric characters. Example: 'PABcd12345e' or 'P1234567890'.",
    "meta": null
  },
  "wp_trace_id": "3b0b537a60d84057817bb40563ca5c99"
}
{
  "message": "Forbidden"
}
{
  "error": {
    "code": 400,
    "message": "Short error message",
    "long_message": "The request was malformed",
    "meta": {
      "field": "email",
      "validation_error": "Invalid email format"
    }
  },
  "wp_trace_id": "550e8400-e29b-41d4-a716-446655440000"
}
{
  "error": {
    "code": 400,
    "message": "Short error message",
    "long_message": "The request was malformed",
    "meta": {
      "field": "email",
      "validation_error": "Invalid email format"
    }
  },
  "wp_trace_id": "550e8400-e29b-41d4-a716-446655440000"
}