Property Search
Get ownership and resident data for any property
The Property Search API returns ownership and resident information for a given property. Use it to identify property owners, find current residents, or verify property details.
V2 API Available: We recommend using the V2 Property API for new integrations. The V2 API provides improved data structure and additional features.
Make Your First Request
Send a Request
Search for property details by address using the V2 API:
curl 'https://api.whitepages.com/v2/property/?street=1600%20Pennsylvania%20Ave%20NW&city=Washington&state_code=DC' \
--header 'X-Api-Key: YOUR_API_KEY'Replace YOUR_API_KEY with your actual API key.
Review the Response
A successful request returns property details with owner and resident information:
{
"result": {
"property_id": "RVMKL8l80mK",
"apn": "0187-S000-0802",
"property_address": {
"full_address": "1600 Pennsylvania Ave NW Washington, DC 20500",
"line1": "1600 Pennsylvania Ave NW",
"city": "Washington",
"state": "DC",
"zip": "20500",
"house": "1600",
"street": "Pennsylvania",
"street_type": "Ave",
"county": "District of Columbia"
},
"mailing_address": {
"full_address": "1600 Pennsylvania Ave NW Washington, DC 20500",
"line1": "1600 Pennsylvania Ave NW",
"city": "Washington",
"state": "DC",
"zip": "20500",
"house": "1600",
"street": "Pennsylvania",
"street_type": "Ave",
"county": "District of Columbia"
},
"geolocation": {
"lat": 38.897697,
"lng": -77.034392
},
"ownership_info": {
"owner_type": "Business",
"business_owners": [
{
"name": "United States Of America"
}
],
"person_owners": [
{
"id": "PX3vr2aM2E3",
"name": "Donald Duck",
"current_addresses": [
{
"full_address": "1600 Pennsylvania Ave NW # 666 Washington, DC 20500"
}
],
"phones": [
{
"number": "12015215520",
"type": "Landline"
}
],
"emails": [
{
"email": "sample.email@gmail.com"
}
]
}
]
},
"residents": [
{
"id": "PX3vr2aM2E3",
"name": "Donald Duck",
"current_addresses": [
{
"full_address": "1600 Pennsylvania Ave NW # 666 Washington, DC 20500"
}
],
"phones": [
{
"number": "12015215520",
"type": "Landline"
}
],
"emails": [
{
"email": "sample.email@gmail.com"
}
]
}
]
}
}The response includes the verified property with geolocation, property owners, and current residents.
Request Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
street | No* | Street address | 1600 Pennsylvania Ave NW |
city | No* | City name | Washington |
state_code | No* | Two-letter state code | DC |
zipcode | No* | ZIP code | 20500 |
At least one parameter is required. Include multiple parameters for more precise results.
Example with ZIP code:
https://api.whitepages.com/v2/property/?street=1600%20Pennsylvania%20Ave%20NW&zipcode=20500Example by property ID:
https://api.whitepages.com/v2/property/RVMKL8l80mKWhat's Next
You've completed the getting started tutorials. Explore the References section for complete API documentation.