Get property details by ID
Retrieve detailed property information by Whitepages property ID. Accepts either a Whitepages property ID (prefix ``R``) or an address ID (prefix ``A``). Address IDs are resolved to the associated property before lookup. This endpoint returns comprehensive property data including physical characteristics, tax assessment information, ownership details, mortgage history, predictive insights, and current residents. To obtain a property_id, first use the "Search for property by address" endpoint (/v2/property/), which returns basic property information including the property_id needed for this request.
Authorization
ApiKeyAuth API key for authentication. Get your key from the Whitepages developer portal.
In: header
Path Parameters
Whitepages property identifier (capital 'R' prefix) or address identifier (capital 'A' prefix). Both are 11 characters long.
"RkzQlEj2kmg""AEoLeWBEeyj"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"
}Retrieve a single event by ID GET
Return a single event by its unique identifier.
Search for property by address GET
Search for property by address parameters. Returns basic property information including property_id, address, owner, and resident details. For comprehensive property details including physical characteristics, tax assessments, and mortgage history, use the returned property_id with the "Get property details by ID" endpoint (/v2/property/{property_id}).