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

Get property details by ID

Retrieve detailed property information by Whitepages property ID. Returns comprehensive property data including physical characteristics, tax assessment information, ownership details, mortgage history, predictive insights, and current residents.

GET
/v2/property/{property_id}

Authorization

ApiKeyAuth

x-api-key<token>

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

In: header

Path Parameters

property_id*string

Unique property identifier

Example"RkzQlEj2kmg"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.whitepages.com/v2/property/RkzQlEj2kmg"
{
  "result": {
    "property_id": "string",
    "address_id": "string",
    "apn": "string",
    "property_address": {
      "full_address": "string",
      "line1": "string",
      "city": "string",
      "state": "string",
      "zip": "string",
      "house": "string",
      "street": "string",
      "street_type": "string",
      "county": "string"
    },
    "mailing_address": {
      "full_address": "string",
      "line1": "string",
      "city": "string",
      "state": "string",
      "zip": "string",
      "house": "string",
      "street": "string",
      "street_type": "string",
      "county": "string"
    },
    "geolocation": {
      "lat": 0,
      "lng": 0
    },
    "year_built": 0,
    "effective_year_built": 0,
    "property_purpose": "string",
    "living_sqft": 0,
    "lot_sqft": 0,
    "ground_floor_sqft": 0,
    "basement_sqft": 0,
    "basement_type": "string",
    "stories": 0,
    "bedrooms": 0,
    "bathrooms": 0,
    "has_pool": true,
    "garage_type": "string",
    "roof_covering": "string",
    "heating_fuel": "string",
    "condition": "string",
    "build_quality": "string",
    "owner_occupied": "string",
    "is_vacant": true,
    "assessed_info": {
      "market_value": 0,
      "assessed_value": 0,
      "property_tax_amount": 0,
      "property_tax_percent": 0
    },
    "ownership_info": {
      "owner_type": "string",
      "sale_date": "string",
      "last_sale_amount": 0,
      "mortgages": [],
      "business_owners": [],
      "person_owners": []
    },
    "residents": []
  }
}
{
  "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": 404,
    "message": "Not Found",
    "long_message": "Person id not found: PABcd12345e",
    "meta": null
  },
  "wp_trace_id": "0c57473114bd49b3b3c4b585df624f2f"
}
{
  "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"
}
{
  "message": "Too Many Requests"
}
{
  "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"
}