Event Payload

When you retrieve an event using the Events API, the response is wrapped in a result envelope containing the full event object described below.

Webhook Notifications

Webhook deliveries do not include the full event payload. Instead, your endpoint receives a lightweight notification with the event type and a link to fetch the complete details:

{
  "event_id": "evt_abc123",
  "event_type": "deed.transfer",
  "links": [
    {
      "version": "1",
      "url": "https://api.whitepages.com/v1/events/evt_abc123"
    }
  ]
}

Use the url in the links array to call the Events API and retrieve the full event object shown below.

Top-Level Fields

Field	Type	Description
`id`	string	Unique event identifier (UUID)
`object`	string	Always `"event"`
`event_type`	string	The type of deed event (see Event Types)
`data`	object	Type-specific event data (see sections below)

Data

The data object contains all event-specific information: jurisdiction, property, parties, and deed detail.

Field	Type	Required	Description
`jurisdiction`	object	Yes	Geographic jurisdiction where the deed was recorded
`property`	object	No	Property involved in the event
`parties`	array	Yes	Individuals or entities involved
`detail`	object	No	Deed-specific transaction detail

Jurisdiction

The jurisdiction object identifies the county and state where the deed was recorded.

Field	Type	Required	Description
`county`	string	No	County name
`state`	string	Yes	Two-letter state abbreviation
`fips_code`	string	No	Federal Information Processing Standards code

Example

{
  "jurisdiction": {
    "county": "King",
    "state": "WA",
    "fips_code": "53033"
  }
}

Property

The property object contains details about the property involved in the deed event. All fields are nullable.

Field	Type	Description
`property_id`	string	Whitepages property identifier
`property_address`	object	Structured address of the property
`apn`	string	Assessor's Parcel Number
`parcel_id`	string	Parcel identifier
`geolocation`	object	Geographic coordinates
`legal_description`	object	Legal description of the property
`bedrooms`	integer	Number of bedrooms
`bathrooms`	number	Number of bathrooms
`living_sqft`	integer	Living area in square feet
`lot_sqft`	integer	Lot size in square feet
`property_purpose`	string	Property type

Address Fields

Field	Type	Description
`line1`	string	Street address
`city`	string	City name
`state`	string	Two-letter state code
`zip`	string	ZIP code
`county`	string	County name

Geolocation Fields

Field	Type	Description
`lat`	number	Latitude
`lng`	number	Longitude

Legal Description Fields

Field	Type	Description
`text`	string	Full legal description as raw text

Example

{
  "property": {
    "property_id": "prop_123",
    "property_address": {
      "line1": "123 Main St",
      "city": "Seattle",
      "state": "WA",
      "zip": "98101",
      "county": "King"
    },
    "apn": "123456-7890",
    "parcel_id": "P-7890",
    "geolocation": {
      "lat": 47.6062,
      "lng": -122.3321
    },
    "legal_description": {
      "text": "LOT 1 BLK 2 SEATTLE LAND CO ADD"
    },
    "bedrooms": 3,
    "bathrooms": 2.5,
    "living_sqft": 1850,
    "lot_sqft": 5000,
    "property_purpose": "single_family"
  }
}

Parties

The parties array lists individuals or entities involved in the deed transaction.

Field	Type	Required	Description
`role`	string	Yes	Party's role: `grantor` (seller) or `grantee` (buyer)
`name`	string	No	Full name of the individual or entity
`type`	string	No	`individual` or `entity`
`person_id`	string	No	Whitepages person ID, if resolved
`addresses`	array	No	Associated addresses

Party Address Fields

Field	Type	Required	Description
`full_address`	string	Yes	Formatted full address

Example

{
  "parties": [
    {
      "role": "grantor",
      "name": "Jane Doe",
      "type": "individual",
      "person_id": "per_456",
      "addresses": [{ "full_address": "123 Main St, Seattle, WA 98101" }]
    },
    {
      "role": "grantee",
      "name": "Acme Properties LLC",
      "type": "entity",
      "person_id": null,
      "addresses": []
    }
  ]
}

Detail

The detail object contains transaction-specific information from the deed record.

Field	Type	Description
`document_type`	object	Document classification
`recorded_date`	string	Date the deed was recorded (ISO 8601)
`instrument_date`	string	Date the deed was executed (ISO 8601)
`consideration`	number	Transaction amount in USD
`transaction_reason`	object	Transaction classification

Document Type Fields

Field	Type	Description
`category`	string	Normalized category
`text`	string	Human-readable label

Transaction Reason Fields

Field	Type	Description
`category`	string	Normalized category
`text`	string	Human-readable label

Example

{
  "detail": {
    "document_type": {
      "category": "deed",
      "text": "Warranty Deed"
    },
    "recorded_date": "2026-02-27",
    "instrument_date": "2026-02-25",
    "consideration": 750000,
    "transaction_reason": {
      "category": "sale",
      "text": "Arms-length sale"
    }
  }
}

Full Example

Complete event response

{
  "result": {
    "id": "evt_abc123",
    "object": "event",
    "event_type": "deed.transfer",
    "data": {
      "jurisdiction": {
        "county": "King",
        "state": "WA",
        "fips_code": "53033"
      },
      "property": {
        "property_id": "prop_123",
        "property_address": {
          "line1": "123 Main St",
          "city": "Seattle",
          "state": "WA",
          "zip": "98101",
          "county": "King"
        },
        "apn": "123456-7890",
        "parcel_id": "P-7890",
        "geolocation": {
          "lat": 47.6062,
          "lng": -122.3321
        },
        "legal_description": {
          "text": "LOT 1 BLK 2 SEATTLE LAND CO ADD"
        },
        "bedrooms": 3,
        "bathrooms": 2.5,
        "living_sqft": 1850,
        "lot_sqft": 5000,
        "property_purpose": "single_family"
      },
      "parties": [
        {
          "role": "grantor",
          "name": "Jane Doe",
          "type": "individual",
          "person_id": "per_456",
          "addresses": [{ "full_address": "123 Main St, Seattle, WA 98101" }]
        },
        {
          "role": "grantee",
          "name": "John Smith",
          "type": "individual",
          "person_id": null,
          "addresses": []
        }
      ],
      "detail": {
        "document_type": {
          "category": "deed",
          "text": "Warranty Deed"
        },
        "recorded_date": "2026-02-27",
        "instrument_date": "2026-02-25",
        "consideration": 750000,
        "transaction_reason": {
          "category": "sale",
          "text": "Arms-length sale"
        }
      }
    }
  }
}

On this page