Explore Documentation

V4 Documentation

Property Object

High level components:

Name: Description:
metadata Metadata related to the request.
address Address details as provided by the assessor.
parcel Parcel details as provided by the assessor.
structure Information about the building(s) on the parcel.
taxes Tax records as provided by the assessor.
assessments Tax assessment information as provided by the assessor.
market_assessments Market assessment data as determined by the assessor.
valuation Valuation details as provided by a proprietary valuation algorithm.
owner Current owner details taken from either the assessment or the latest deed, whichever is more recent.
deeds Up to 20 years of sale and mortgage data which constitute a deed record.

metadata:

Metadata related to the request.

Field: Description:
publishing_date string [YYYY-MM-DD] The date the data was made available at the source.
Eg. 2018-02-14

address:

Address details as provided by the assessor.

Field: Description:
street_number string Parsed street number.
Eg. 3450
street_pre_direction string Directional appearing before the street name.
Eg. N
street_name string Parsed street name. Numeric street names will include ordinal suffixes (st, nd, rd, th)
Eg. Main
street_suffix string Standardized and parsed street suffix abbreviation.
Eg. St
street_post_direction string Directional appearing after street suffix denoting quadrant.
Eg. SW
unit_type string Unit type abbreviation.
Eg. Apt
unit_number string Unit number (may be alphanumeric).
Eg. 101A
formatted_street_address string Combined street address (including unit).
Eg. 1650 N 16th St SW Apt 101
city string City name.
Eg. Chicago
state string State abbreviation.
Eg. IL
zip_code string Zip code.
Eg. 60614
zip_plus_four_code string Four digit postal zip extension.
Eg. 5505
carrier_code string USPS code for mail delivery services.
Eg. R001
latitude float Measured latitude for the property.
Eg. 41.912406
longitude float Measured longitude for the property.
Eg. -87.649191
geocoding_accuracy string Describes the level of geocoding match.
Eg. Parcel Centroid
census_tract string The census tract as designated by the Census Bureau.
Eg. 10570200.002009

parcel:

Parcel details as provided by the assessor.

Field: Description:
apn_original string The formatted assessor's parcel number.
Eg. 001-090-04-02
apn_unformatted string The unformatted assessor's parcel number.
Eg. 0010900402
apn_previous string A previous assessor's parcel number, formatted.
Eg. 001-090-04-00
fips_code string Unique County identifier, first 2 digits are state FIPS.
Eg. 12086
depth_ft integer Depth measurement of the parcel in feet.
Eg. 120
frontage_ft integer Frontage measurement of the parcel in feet.
Eg. 260
area_sq_ft integer Total area of the parcel in square feet.
Eg. 31200
area_acres float Total area of the parcel in acres.
Eg. 0.716
county_name string The name of the county.
Eg. Cook
county_land_use_code string The land use code as provided directly from the county, without interpretation.
Eg. SFR01
county_land_use_description string The land use description as provided by directly from the county, without interpretation.
Eg. RESIDENTIAL SINGLE DWELLING
standardized_land_use_category string The general land use category for the property, converted to a common set of values across all counties.
Eg. Multi-Family Residential
standardized_land_use_type string Describes further granularity into the land use type, converted to a common set of values across all counties.
Eg. Townhouse
location_descriptions [string] List describing the location and surrounding area.
Eg. In Cul-de-sac, Has Mountain view
zoning string City zoning designation, unique to each incorporated area.
Eg. T/G
building_count integer Count of all buildings on the property.
Eg. 1
tax_account_number string Parcel identifier used by the tax assessor.
Eg. 0134601209K
legal_description string Legal description as provided by the assessor.
Eg. Legal subdivision 4, Section 10, Township 82, West of the 6th Meridian, New York District
lot_code string Indicates properties with multiple or partial lots.
Eg. More than one lot
lot_number string Number(s) identifying individual lots making up a property, separated by a comma (,), or ampersand (&). Ranges are denoted by a hyphen (-).
Eg. 1-13,15
subdivision string The name of the subdivision, plat, or tract in which the property is located
Eg. CRYSTAL LAKE FOREST
municipality string The jurisdiction in which the property is located.
Eg. FELL TOWNSHIP
section_township_range string Section township range meridian identifier.
Eg. SEC 14 TWN 1N RNG 11E

structure:

Information about the building(s) on the parcel.

Field: Description:
year_built integer The year the structure was built.
Eg. 1923
effective_year_built integer The year a structure was substantially updated or improved.
Eg. 1996
stories string The number of stories comprising the structure (may include fractional stories such as +A for attic).
Eg. 2+A
rooms_count integer The total number of rooms in the building (not just bedrooms).
Eg. 4
beds_count integer The number of bedrooms in the building.
Eg. 3
baths float The total number of bathrooms in the building, including half baths.
Eg. 2.5
partial_baths_count integer The number of partial bathrooms in the building, when available.
Eg. 2
units_count integer Total number of units reported to the county.
Eg. 1
parking_type string The type of parking available.
Eg. Detached Garage
parking_spaces_count integer The total number of available parking spaces; including garage, carport, driveway.
Eg. 2
pool_type string Type of pool located on the property - shared or private.
Eg. Heated Pool
architecture_type string Style or historical period of the primary structure.
Eg. Spanish
construction_type string Type of material used in construction of the building.
Eg. Wood
exterior_wall_type string Material used for the exterior walls of the building.
Eg. Stucco
foundation_type string The type of material used in the foundation.
Eg. Concrete
roof_material_type string The material used for the roof of the building.
Eg. Asphalt
roof_style_type string The architectural style for the roof of the building.
Eg. Gable
heating_type string Primary heating type for the building.
Eg. Baseboard
heating_fuel_type string Type of fuel used to heat the building.
Eg. Gas
air_conditioning_type string Air conditioning type for the building.
Eg. Central
fireplaces string Total number of fireplaces in the building (can also be "Y")
Eg. 2
basement_type string Basement type for the building.
Eg. Full Basement
quality string The quality of the structure rated from A+ to E+.
Eg. A+
condition string Current condition of the structure provided by the county.
Eg. Fair
flooring_types [string] Type of flooring used in improvements in the building.
Eg. Carpet, Marble
plumbing_fixtures_count integer Total number of all plumbing fixtures in the building.
Eg. 1
interior_wall_type string The type of material used for the interior walls.
Eg. Plaster
water_type string The water system for the property.
Eg. Municipal
sewer_type string The waste disposal/sewage system for the property.
Eg. Septic
total_area_sq_ft integer Total square footage of structure.
Eg. 1692
other_areas [object {type: string, sq_ft: string}] List of objects describing areas within the building, and their corresponding size in sq ft.
{
    type: "1st Floor",
    sq_ft: "1140"
}
other_features [object {type: string, sq_ft: string}] List of objects describing features in or around the building, and their corresponding size in sq ft.
{
    type: "Driveway",
    sq_ft: "240"
}
other_improvements [object {type: string, sq_ft: string}] List of objects describing improvements to the property or building, and their corresponding size in sq ft.
{
    type: "Greenhouse",
    sq_ft: "346"
}
other_rooms [string] List of other rooms within the building.
Eg. Laundry Room, Home Office
amenities [string] List of amenities included in the property.
Eg. Wine Cellar, Tennis Court

taxes:

Tax records as provided by the assessor.

Field: Description:
year int [YYYY] The year the tax was levied.
Eg. 2017
amount integer The amount of tax on the property in dollars.
Eg. 2247
exemptions [string] List of exemptions.
Eg. Agricultural, Low Income
rate_code_area string Represents separate tax jurisdictions within the county as provided on the county tax/assessment roll.
Eg. 01H

assessments:

Tax assessment information as provided by the assessor.

Field: Description:
year int [YYYY] The year the assessment was performed.
Eg. 2018
land_value integer The current assessed land value before any exemptions in dollars.
Eg. 2580
improvement_value integer The current assessed improvement value before any exemptions in dollars.
Eg. 13300
total_value integer The total current assessed value of both land and improvements before any exemptions in dollars.
Eg. 15880

market_assessments:

Market assessment data as determined by the assessor.

Field: Description:
year int [YYYY] The year the market assessment was performed.
Eg. 2017
land_value integer The market land value as determined by the assessor.
Eg. 3000
improvement_value integer The market improvement value as determined by the assessor.
Eg. 12000
total_value integer The total market value as determined by the assessor.
Eg. 15000

valuation:

Valuation details as provided by a proprietary valuation algorithm.

Field: Description:
value integer The current property value.
Eg. 16430
high integer The highest probable value.
Eg. 17220
low integer The lowest probable value.
Eg. 15780
forecast_standard_deviation integer [percentage 0-100] Forecast standard deviation.
Eg. 55
date string [YYYY-MM-DD] The date the valuation was performed.
Eg. 2019-10-24

owner:

Current owner details taken from either the assessment or the latest deed, whichever is more recent.

Field: Description:
name string Assessed owner name.
Eg. John Smith
second_name string Second assessed owner name when provided by county.
Eg. Jane Smith
formatted_street_address string The address where the current tax bill is mailed (not including unit).
Eg. 123 Main St
unit_type string The unit type.
Eg. Apt
unit_number string The unit number.
Eg. 104
city string The city where the current tax bill is mailed. In the case it is out of USA, the county will also be located here.
Eg. Atlanta
state string The state abbreviation where the current tax bill is mailed; XX for out of country addresses.
Eg. GA
zip_code string The zip code where the current tax bill is mailed.
Eg. 30342
zip_plus_four_code string Four digit postal zip extension for where the tax bill is mailed.
Eg. 3019
owner_occupied string Description of the owner occupancy. Can be "YES" or "PROBABLE". Data not available if null.
Eg. Yes

deeds:

Up to 20 years of sale and mortgage data which constitute a deed record.

Field: Description:
document_type string Type of deed document.
Eg. Warranty Deed
recording_date string [YYYY-MM-DD] The official date the document was recorded.
Eg. 2011-12-28
original_contract_date string [YYYY-MM-DD] The date the original contract was signed.
Eg. 2011-12-26
deed_book string The physical book where the deed was recorded.
Eg. 9056
deed_page string The physical page where the deed was recorded.
Eg. 595
document_id string Identifier assigned to document at the recording date.
Eg. 93154L
sale_price integer The total sale price in dollars.
Eg. 170000
sale_price_description string A description of the sale.
Eg. Estimated
transfer_tax float The tax amount levied by the city, county, or a combination thereof.
Eg. 142.03
distressed_sale boolean An indicator to determine if the sale was deemed to be distressed.
Eg. false
real_estate_owned string An indicator used to determine the status of the transfer.
Eg. NO
seller_first_name string Seller first name, or null if corporate owner.
Eg. John
seller_last_name string Seller last name, or corporate name.
Eg. Smith
seller2_first_name string The second seller first name, or null if corporate owner.
Eg. Jane
seller2_last_name string The second seller last name, or corporate name.
Eg. Smith
seller_address string The seller mailing address.
Eg. 123 Main St
seller_unit_number string The seller unit number.
Eg. 1
seller_city string The seller city.
Eg. Phoenix
seller_state string The seller mailing state.
Eg. AZ
seller_zip_code string Seller zip code.
Eg. 85024
seller_zip_plus_four_code string Seller four digit postal zip extension.
Eg. 3019
buyer_first_name string Buyer first name, or null if corporate owner.
Eg. John
buyer_last_name string Buyer last name, or corporate name.
Eg. Smith
buyer2_first_name string Second buyer first name, or null if corporate owner.
Eg. Jane
buyer2_last_name string Second buyer last name, or corporate name.
Eg. Smith
buyer_address string Buyer mailing address.
Eg. 123 Main St
buyer_unit_type string Buyer unit type.
Eg. Apt
buyer_unit_number string Buyer unit number.
Eg. 1A
buyer_city string Buyer mailing city.
Eg. Denver
buyer_state string Buyer mailing state.
Eg. CO
buyer_zip_code string Buyer mailing zip code.
Eg. 80222
buyer_zip_plus_four_code string Buyer four digit postal zip extension.
Eg. 3019
lender_name string Mortgage lender.
Eg. CITIMORTGAGE INC
lender_type string The type of lender.
Eg. Bank
loan_amount integer Mortgage recorded in dollars.
Eg. 74900
loan_type string Type of loan security.
Eg. Closed Mortgage
loan_due_date string [YYYY-MM-DD] The date the mortgage will be paid in full.
Eg. 2029-10-22
loan_finance_type string The interest rate type on the loan.
Eg. Fixed Rate
loan_interest_rate float The interest rate of the loan.
Eg. 2.97