Introducing Webhooks — Get live property deed updates delivered to you. Learn more →
Whitepages
DocumentationReferences
ReferencesEvents

Search deed events

Search historical deed events by region, date range, and property identifier.

GET
/v1/events/deed

Authorization

ApiKeyAuth

x-api-key<token>

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

In: header

Query Parameters

region*string

Geographic scope in type:value format (e.g., state:tx, county:tx.travis, county:48453)

property_id?Property Id|Property Id

Whitepages property ID filter

event_date_from?Event Date From|Event Date From

Start of event date range, inclusive (ISO 8601)

event_date_to?Event Date To|Event Date To

End of event date range, inclusive (ISO 8601)

limit?integer

Results per page

Default20
Range1 <= value <= 100
cursor?Cursor|Cursor

Pagination cursor from a previous response

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.whitepages.com/v1/events/deed?region=string"
{
  "results": [
    {
      "id": "string",
      "object": "event",
      "event_type": "string",
      "data": {
        "jurisdiction": {
          "county": "string",
          "state": "string",
          "fips_code": "string"
        },
        "property": {
          "property_id": "string",
          "property_address": {
            "line1": "string",
            "city": "string",
            "state": "string",
            "zip": "string",
            "county": "string"
          },
          "apn": "string",
          "parcel_id": "string",
          "geolocation": {
            "lat": 0,
            "lng": 0
          },
          "legal_description": {
            "text": "string"
          },
          "bedrooms": 0,
          "bathrooms": 0,
          "living_sqft": 0,
          "lot_sqft": 0,
          "property_purpose": "string"
        },
        "parties": [
          {
            "role": "string",
            "name": "string",
            "type": "string",
            "person_id": "string",
            "addresses": [
              {
                "full_address": "string"
              }
            ]
          }
        ],
        "detail": {
          "document_type": {
            "category": "string",
            "text": "string"
          },
          "recorded_date": "string",
          "instrument_date": "string",
          "consideration": 0,
          "transaction_reason": {
            "category": "string",
            "text": "string"
          }
        }
      }
    }
  ],
  "pagination": {
    "next_cursor": "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"
}