Skip to main content

New Property Attributes Reference

Reference for the newly audited property attributes now returned in Property Search and Property Lookup responses, including which dataset returns each field and how the contact compliance fields work.

Written by Charles Parra

A set of newly audited property attributes is now returned in Property Search (/api/v1/property/search) and Property Lookup (/api/v1/property/lookup) responses wherever the underlying data is present. These attributes are response-only: they are returned in the response, but they are not new searchable filter criteria. There is no change to request cost.

Each attribute belongs to an existing dataset. A field only appears in a response when its dataset is requested in datasets and your account is entitled to that dataset. If a field is not present for a property, the data was not available for that record.

New attributes by dataset

Core dataset (core)

Field path

Type

What it means

building.grossBuildingAreaSquareFeet

integer

Total gross building area in square feet, counting all floors and enclosed space. Broader than living area.

building.adjustedBuildingAreaSquareFeet

integer

Building area adjusted by the assessor to a comparable basis (areas like garages, basements, and porches are weighted differently from primary living space).

general.mobileHome

boolean

Indicates the property is a mobile or manufactured home.

general.vacantDate

string (date)

The date the property was flagged as vacant.

History (Deed) dataset (deed)

Field path

Type

What it means

deedHistory.ownerRelationshipType

string

The relationship between buyer and seller on the deed, for example an arms-length sale versus a related-party or intra-family transfer.

deedHistory.salePriceCode

string

A code describing the nature of the recorded sale price, for example full consideration versus a nominal or partial amount.

deedHistory.transferTax

number

The documentary transfer tax recorded on the deed.

deedHistory.multipleOwners

boolean

Indicates the deed records more than one owner (the "et al" indicator).

Mortgage and Open Liens dataset (mortgageliens)

These attributes are flags and riders on the first mortgage. They live inside the existing openLien.mortgages array, so you will find them on each mortgage entry rather than at the top level.

Field path

Type

What it means

openLien.mortgages.subordinateLoanFlag

boolean

An additional subordinate (junior) loan is present alongside the first mortgage.

openLien.mortgages.equityFlag

boolean

The loan is an equity loan.

openLien.mortgages.helocFlag

boolean

The loan is a home equity line of credit (HELOC).

openLien.mortgages.pudRider

boolean

A Planned Unit Development rider is attached to the mortgage.

openLien.mortgages.condoRider

boolean

A condominium rider is attached.

openLien.mortgages.multiFamilyRider

boolean

A multi-family (2 to 4 unit) rider is attached.

openLien.mortgages.assumable

boolean

The mortgage carries an assumability rider, so the loan may be assumable.

openLien.mortgages.privateLender

boolean

The lender is a private party rather than an institution.

openLien.mortgages.secondHomeRider

boolean

A second-home rider is attached.

openLien.mortgages.sellerCarryBack

boolean

The seller carried back financing (seller-financed).

openLien.mortgages.balloonRider

boolean

A balloon-payment rider is attached.

Contact Enrichment dataset (contact)

Field path

Type

What it means

owner.mailingOptOut

boolean

The contact has opted out of postal marketing mail.

owner.hasLandline

boolean

A landline phone is associated with the contact, as opposed to mobile only.

Demographics dataset (demographic)

Field path

Type

What it means

demographics.emailDomain

string

The domain portion of the contact's email address, for example gmail.com.

How these relate to existing fields

A few of the new fields are close in name to fields you may already use. Here is how they differ:

  • general.vacantDate is a date. The existing general.vacant is a boolean that tells you whether a property is currently flagged vacant. Use general.vacant for "is it vacant" and general.vacantDate for "since when."

  • building.grossBuildingAreaSquareFeet and building.adjustedBuildingAreaSquareFeet are distinct from the existing building.totalBuildingAreaSquareFeet and building.livingAreaSquareFeet. Gross area is the broadest measure, adjusted area is the assessor's comparable basis, living area is heated and finished living space.

  • general.mobileHome is a single flag. It does not replace the existing property type and land use fields, it complements them.

  • Available equity is not part of this release. The existing valuation field for estimated equity remains the source for equity figures.

Contact compliance fields

Two of the new contact fields carry compliance meaning. Treat them as inputs to your own compliance process, not as a guarantee that any given contact is legal to reach.

  • owner.mailingOptOut: when true, the contact has asked not to receive marketing mail. Honor the mailing opt out and suppress that contact from mail campaigns.

  • owner.hasLandline: this distinguishes landline from mobile, which matters for TCPA rules that treat calls and texts to mobile numbers differently from landlines.

These sit alongside the existing phone compliance signals such as owner.dnc.tcpa and owner.phoneNumbers.dnc. Combine them with your internal suppression lists and consent records before any outreach.

Did this answer your question?