Property Ownership
The Mashvisor database contains historical data on property owners' contact information, demographics, lifestyle, interests, financials, and estimated household income. Use these endpoints to retrieve owner data by property (parcel, MLS id, or address) or by name and location.
The Ownership Objects
Mashvisor database contains historical data on property owners' contact information, demographics, lifestyle, interests, financials, and estimated household income.
The Contact Object:
{
"status": "success",
"content": {
"id": 9087,
"first_name": "Samantha",
"last_name": "Reed",
"email_address": "[email protected]",
"phone_number": "(415) 555-8234",
"line_type": "Mobile",
"address": "123 Market St",
"city": "San Francisco",
"state": "CA",
"zip_code": "94103",
"created_at": "2022-04-20T10:15:30.000Z",
"updated_at": "2024-10-05T18:42:11.000Z"
}
}
Owner Data Dictionary
| Attribute | Definition | Possible Returns |
|---|---|---|
| First Name | Owner first name | String |
| Last Name | Owner last name | String |
| Phone Number | Phone number, including area code | Integer |
| Line Type | Landline or Mobile | String |
| Email Address | Owner email address | String |
| Address | Street address | String |
| City | City name | String |
| state* | State abbreviation | String |
| Zip Code | Zip code | Integer |
| DOB | Month and year of person's birth | String |
| Age Range | Age range of the person | String |
| Ethnicity | Ethnicity of the person | String |
| Single Parent | Is single parent presence in household | String |
| Senior Adult Household | Yes or null | String |
| Young Adult Household | Yes or null | String |
| Business Owner | Business owner; Accountant, Builder, Director, etc. | String |
| Language | Primary language | String |
| Religion | Person's religion | String |
| Number of Children | Children within the household | Integer |
| Presence of Children | Yes or null | String |
| Education | Highest level of education | String |
| Occupation | Industry of occupation | String |
| Gender | Male or Female | String |
| Marital Status | Single or Married | String |
| Own/Rent | Own or rent household | String |
| Social Presence Indicator | Whether the person has an account on social networks or not, Yes or null | String |
| Magazines | If there's a match, the title will be listed | String |
| Technology | If there's a match, the title will be listed | String |
| Dieting and Wellness | If there's a match, the title will be listed | String |
| Exercise | If there's a match, the title will be listed | String |
| DIY Home Improvement | If there's a match, the title will be listed | String |
| Jewelry | If there's a match, the title will be listed | String |
| Mail Order Buyer | If there's a match, the title will be listed | String |
| Membership Clubs | If there's a match, the title will be listed | String |
| Online Education | If there's a match, the title will be listed | String |
| Spectator Sports | If there's a match, the title will be listed | String |
| Outdoor Sports | If there's a match, the title will be listed | String |
| Investing | If there's a match, the title will be listed | String |
| Books | If there's a match, the title will be listed | String |
| Political Donor | If there's a match, the title will be listed | String |
| Hobbies and Crafts | If there's a match, the title will be listed | String |
| Cosmetics | If there's a match, the title will be listed | String |
| Travel | If there's a match, the title will be listed | String |
| Charitable Donations | If there's a match, the title will be listed | String |
| Arts and Antiques | If there's a match, the title will be listed | String |
| Pet Owner | If there's a match, the title will be listed | String |
| Cooking | If there's a match, the title will be listed | String |
| DIY Auto work | If there's a match, the title will be listed | String |
| Health and Beauty | If there's a match, the title will be listed | String |
| Parenting | If there's a match, the title will be listed | String |
| Music | If there's a match, the title will be listed | String |
| Film and Movies | If there's a match, the title will be listed | String |
| Self Improvement | If there's a match, the title will be listed | String |
| Womens Apparel | Yes or null | String |
| Est. Household Income | Estimated household income | String |
| Length of Residence | Length of residence | String |
| Home Purchase Date | Estimated date of home purchase | Date |
| Est. Home Purchase Price | Estimated price of home purchase | String |
| Dwelling Type | Single family or multi-family | String |
| Auto year | Year of automobile | Integer |
| Number of credit lines | Number of lines of credit | Integer |
| Auto make | Make of automobile | String |
| Credit card holder | Yes or null | String |
| Auto model | Model of automobile | String |
| Est. Home Value | Estimated home value | String |
| Auto edition | Edition of automobile | String |
| Est. Net Worth | Estimated net worth | String |
| Gas credit card holder | Yes or null | String |
| Upscale card holder | Yes or null | String |
| Wealth Score | Measure of wealth, 0 - 100 | Integer |
GET/v1.1/client/owner/contact
Get Contact Info
Retrieves contact details for a single property owner. Identify the property by one of: parcel_number, mls_id, or address + city + state + zip_code.
Query parameters
- Name
parcel_number- Type
- string
- Description
Property parcel or APN.
- Name
mls_id- Type
- string
- Description
Property MLS id.
- Name
address- Type
- string
- Description
Property street address.
- Name
city- Type
- string
- Description
Property city.
- Name
state- Type
- string
- Description
Property state. Required.
- Name
zip_code- Type
- string
- Description
Property zip code.
Request
GET
/v1.1/client/owner/contactcurl -G "https://api.mashvisor.com/v1.1/client/owner/contact" \
-d "mls_id=FC314771" \
-d "state=FL" \
-H "x-api-key: YOUR_API_KEY"
Response
{
"status": "success",
"content": {
"id": 3640095,
"first_name": "John",
"last_name": "Smith",
"email_address": null,
"phone_number": "3488811111",
"line_type": "Mobile",
"address": "7 SEDGWICK TRL",
"city": "Palm Coast",
"state": "FL",
"zip_code": "32164",
"created_at": "2025-12-30T11:15:24.000Z",
"updated_at": "2026-01-20T10:54:11.000Z"
}
}
GET/v1.1/client/owner/demographics
Get Demographics
Retrieves the property owners' demographics when matching on a full name, phone number, email address, or on a complete mailing address.
Query parameters
- Name
first_name- Type
- string
- Description
First name.
- Name
last_name- Type
- string
- Description
Last name.
- Name
phone_number- Type
- string
- Description
Person phone number.
- Name
email_address- Type
- string
- Description
Person email address.
- Name
address- Type
- string
- Description
Property street address.
- Name
zip_code- Type
- string
- Description
Property zip code.
- Name
city- Type
- string
- Description
Property city.
- Name
state- Type
- string
- Description
Property state. Required.
Request
GET
/v1.1/client/owner/demographicscurl -G "https://api.mashvisor.com/v1.1/client/owner/demographics" \
-d "state=FL" \
-d "first_name=JUSTINA" \
-d "last_name=NIN" \
-H "x-api-key: YOUR_API_KEY"
Response
{
"status": "success",
"content": {
"dob": "193709",
"age_range": "85-95",
"ethnicity": null,
"single_parent": null,
"senior_adult_household": "YES",
"young_adult_household": null,
"business_owner": null,
"language": "English",
"religion": "Buddhist",
"number_of_children": null,
"presence_of_children": null,
"education": null,
"occupation": "Other",
"gender": "Female",
"marital_status": "Married",
"owner_renter": null,
"social_presence_indicator": null
}
}
GET/v1.1/client/owner/lifeint
Get Lifestyle and Interests
Retrieves the property owners' lifestyle and interests when matching on a full name, phone number, email address, or on a complete mailing address.
Query parameters
- Name
first_name- Type
- string
- Description
First name.
- Name
last_name- Type
- string
- Description
Last name.
- Name
phone_number- Type
- string
- Description
Person phone number.
- Name
email_address- Type
- string
- Description
Person email address.
- Name
address- Type
- string
- Description
Property street address.
- Name
zip_code- Type
- string
- Description
Property zip code.
- Name
city- Type
- string
- Description
Property city.
- Name
state- Type
- string
- Description
Property state. Required.
Request
GET
/v1.1/client/owner/lifeintcurl -G "https://api.mashvisor.com/v1.1/client/owner/lifeint" \
-d "state=FL" \
-d "first_name=JUSTINA" \
-d "last_name=NIN" \
-H "x-api-key: YOUR_API_KEY"
Response
{
"status": "success",
"content": {
"magazines": "YES",
"technology": "YES",
"dieting_and_wellness": null,
"exercise": "YES",
"diy_home_improvement": null,
"jewelry": null,
"mail_order_buyer": "YES",
"membership_clubs": null,
"online_education": null,
"spectator_sports": null,
"outdoor_sports": null,
"investing": "YES",
"books": "YES",
"political_donor": null,
"hobbies_and_crafts": null,
"cosmetics": null,
"travel": "YES",
"charitable_donations": null,
"arts_and_antiques": "YES",
"pet_owner": "YES",
"cooking": null,
"diy_auto_work": null,
"health_and_beauty": null,
"parenting": null,
"music": null,
"film_and_movies": null,
"self_improvement": null,
"womens_apparel": "YES"
}
}
GET/v1.1/client/owner/finhouse
Get Financials, Household Incomes
Retrieves property owners' financials, household income, and wealth score when matching on a full name, phone number, email address, or on a complete mailing address.
Query parameters
- Name
first_name- Type
- string
- Description
First name.
- Name
last_name- Type
- string
- Description
Last name.
- Name
phone_number- Type
- string
- Description
Person phone number.
- Name
email_address- Type
- string
- Description
Person email address.
- Name
address- Type
- string
- Description
Property street address.
- Name
zip_code- Type
- string
- Description
Property zip code.
- Name
city- Type
- string
- Description
Property city.
- Name
state- Type
- string
- Description
Property state. Required.
Request
GET
/v1.1/client/owner/finhousecurl -G "https://api.mashvisor.com/v1.1/client/owner/finhouse" \
-d "state=FL" \
-d "first_name=JUSTINA" \
-d "last_name=NIN" \
-H "x-api-key: YOUR_API_KEY"
Response
{
"status": "success",
"content": {
"est_household_income": "$100,000-149,999",
"length_of_residence": "11 - 15 years",
"home_purchase_date": null,
"est_home_purchase_price": null,
"dwelling_type": "Single Family Dwelling Unit",
"auto_year": null,
"number_of_credit_lines": "1",
"auto_make": null,
"credit_card_holder": "YES",
"auto_model": null,
"est_home_value": "$500,000-749,999",
"auto_edition": null,
"est_net_worth": "> $499,999",
"gas_credit_card_holder": "YES",
"upscale_card_holder": "YES",
"wealth_score": null
}
}