Property Data API Schema

API Schema

Property components:

Name: Description:
metadata Metadata about the property
address The matching address result
site Details on the site for the property
structures Array of all structures recorded for this property
owners Array of all current and previous owners on file
taxes Array of all tax records on file
sales Array of all sales records on file
mortgages Array of all mortgage records on file
valuation Computed valuation for the subject property
status Information about the current residency, market and legal status of the property
postal USPS information for this property
boundaries Property boundaries
comparables Up to 10 Comparable properties + details

metadata:

Metadata about the property

Name: Type: Example: Description:
property_id integer 32452 Unique ID of property in our database
property_classification_code string RSF0115 Code that breaks down to say residential, single family, less than 1000 sq ft
address_match string exact Shows if the property is an exact or partial match
updated_at datetime Last update timestamp. Please note that data is frequently refreshed, but this timestamp represents when the last change made. This change could be to any element of the record, but does not necessarily mean that all fields were refreshed.
error_message string

address:

The matching address result

Name: Type: Example: Description:
street_number string 100 Standardized and parsed street number
street_name string 26th Standardized and parsed street name
street_pre_direction string N Standardized and parsed street direction
street_direction string N Standardized and parsed street direction
street_suffix string St Standardized and parsed street suffix
unit_type string Apt Unit type for subject property
unit_number string B Unit number of subject property
formatted_street_address string 100 26th N St. Combined street address
city string Columbus Standard and parsed city
state string GA State abbreviation
zip_code string 13215 Zip code
zip_code_plus_four string 8433 Zip code plus 4
latitude decimal 32.487930000 Latitude
longitude decimal -84.991127000 Longitude

site:

Details on the site for the property

Name: Type: Example: Description:
sublocality_id integer Not used
locality_id integer Not used
zoning string RU6 Zoning
zoning_category string Residential Zoning category
zoning_description string Single Family Residence Land use description
depth integer 100 Depth of lot in feet
width integer 64 Width of lot in feet
size integer 6354 Square footage of lot
acres decimal 0.1500 Lot size in acres
range string 01W
township string 10
section string 34
block string 019
lot string 008
parcel_id string 007-019-008 Parcel Id
tax_account_id string 56772008 Tax account number used by assessment authority
legal_description string LOTS 8, 9 AND 10, BLOCK 801...
title string Freehold Estate title: Freehold, Leasehold, Strata, etc.
view string Mountain Description of the view
location_description string City Description of the location
building_count integer 1 Number of buildings on the property
land_use_code string 1320 The original county or city land use code

structures:

Array of all structures recorded for this property

Name: Type: Example: Description:
year_built integer 1923
effective_year_built integer 1996 The year a structure was substantially updated
rooms_count integer 4
beds_count integer 2
baths_count integer 2
half_baths_count integer 1
full_baths_count integer 1
quarter_baths_count integer 1
three_quarter_baths_count integer 1
stories_count integer 1
units_count integer 0
total_size integer 1692 Total square footage of building
finished_size integer 1492 Total square footage of living area
unfinished_size integer 200 Total square footage of unfinished spaces
basement_size integer 800 Square footage of basement
garage_size integer 1000 Square footage of garage
architecture_type string Spanish
exterior_wall_type string Stucco
air_conditioning_type string Central
basement_type string Finished
building_type string Single Family
category string
condition string Excellent Current condition of the buildings
quality string Excellent Quality of construction of the buildings
construction_type string Brick/Stucco
fireplace_count integer 1
fireplace_type string Brick Chimney
foundation_type string Block
flooring_type string Wood
garage_type string Garage/Carport
heating_type string Gas
mobile_home boolean false
parking_spaces integer 2
parking_type string Driveway
pool_type string Pool & waterfall
roof_type string Clay tile
roof_style_type string Gable/Hip
electricity_type string Overhead wires
fuel_type string Gas
sewer_type string Public
water_type string Public

owners:

Array of all current and previous owners on file

Name: Type: Example: Description:
name string Cheng Bernard Full name of owner
suffix string Mr. Suffix of owner
first_name string Bernard Owner first name
middle_name string Owner middle name
last_name string Cheng Owner last name
gender string male Gender of owner
second_name string Cheng Susan Name of second owner
second_suffix string Mrs. Suffix of second owner
second_first_name string Susan Second owner first name
second_middle_name string Second owner middle name
second_last_name string Cheng Second owner last name
second_gender string female Gender of second owner
email string bernard_cheng@hotmail.com Owner email address
phone string 2121231234 Phone number of owner with no formatting
address string 220 S Rodeo Dr
address2 string
city string Beverly Hills
state string CA
zip_code string 90212
corporate_flag boolean false Corporate ownership indicator
started_at date 2013-01-01 Date ownership started
ended_at date 2016-07-25 Date ownership relinquished

taxes:

Array of all tax records on file

Name: Type: Example: Description:
tax_year integer 2016 Tax year
tax_amount integer 705 Tax amount
land integer 1743 Assessed land value
improvement integer 5079 Assessed improvements value
total integer 6933 Total Assessment
appraised_land integer 2200 County market land appraisal
appraised_improvement integer 6250 County market improvement appraisal
appraised_total integer 8450 County market total appraisal
outstanding_tax decimal 233.16 Unpaid tax
exemptions array [] Array of exemptions
details array ["tax_account_id":"56780909"] Extra details

sales:

Array of all sales records on file

Name: Type: Example: Description:
date date 2009-08-21 Date of sale
recording_date date 2009-09-25 Recording date of sale
price integer 170000
hpi_adjusted_price_2010 integer 176000 Sale price, adjusted to 2010 dollars
type string Deed of Trust
seller string Mahboubi-Fardi Behrouz & Minoo Seller name
buyer string Cheng Bernard Buyer name
multiAPN boolean
deed_book string
deed_page string
transaction_id string
document_year integer
details array ["listing brokerage":"Columbia Homes"] Extra details

mortgages:

Array of all mortgage records on file

Name: Type: Example: Description:
amount integer 74900 Initial principal
loan_type string Conventional Type of loan security
deed_type string Deed of Trust Mortgage deed type
term integer 25 Length of mortgage in years
date date 2009-08-24 Date document recorded
due_date date 2034-08-21 Mortgage expiry
lender_name string M&I BK FSB Mortgage lender
details array ["term":"7 years","rate_type":"VRM"] Any other mortgage particulars available.

valuation:

Computed valuation for the subject property

Name: Type: Example: Description:
value integer 189000
type string calculated Describes the source of the calculation. Possible values are "calculated", "estimated", "appraised
confidence decimal 0.90 Confidence level for the low-high confidence interval
high integer 178000 The highest price this property should yield in a sale
low integer 201000 The lowest price this property should yield in a sale
suggested_rental integer 1200 Not yet available
market_value_change_year decimal 12.5 Not yet available
market_value_change_quarter decimal 3.6 Not yet available
forecast_1_year decimal Not yet available
version float

status:

Information about the current residency, market and legal status of the property

Name: Type: Example: Description:
rental boolean true Rental property
vacant boolean false True if the property has been vacant for 90 days or more
market_status string For sale Not yet available
foreclosure string Bank pre-foreclosure Not yet available
rental_price decimal 1425.00 Not yet available
listing_price decimal 246000.00 Not yet available
details array ["Foreclosure bank":"Klondike Savings and Loan"] Not yet available

postal:

USPS information for this property

Name: Type: Example: Description:
carrier_code string R001
delivery_point_code integer 17
delivery_point_check_digit integer 6
validated string Y This address corresponds to a USPS record.
deliverable string Y This address gets mail.
details array [] Not yet available

boundaries:

Property boundaries

Name: Type: Example: Description:
geoJSON JSON object [{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[-77.1776712339,39.8118263489],[-77.1776819674,39.8118146587],[-77.1781679287,39.8119998984],[-77.1782140898,39.8120174939],[-77.1780663605,39.8122462932],[-77.1780202082,39.8122286838],[-77.1774882025,39.8120256939],[-77.1776712339,39.8118263489]]]},"properties":[]}] geoJSON object
WKT string POLYGON((-73.8458249137 40.8635823687,-73.8458252305 40.8635723466,-73.845826977 40.8635169823,-73.8461962029 40.8635244916,-73.8461941385 40.8635898797,-73.8458249137 40.8635823687)) WKT (well-known text) format

comparables:

Up to 10 comparable properties are returned, each one following this schema, comprising these elements:

Components:
metadata
address

Comparable metadata:

Metadata about the comparable property

Name: Type: Example: Description:
property_id integer 32452 Unique ID of property in our database
comp_score float 9.5 How related is the property, out of 10
distance float 0.5 Distance from the subject property, in miles

Geographic components:

Name: Description:
districts District information relating to the subject property
entities Lists of amenities/features nearby the subject property

districts:

District information relating to the subject property

Name: Type: Example: Description:
neighborhood string Discovery District Name of Neighborhood
census_tract string 0607022041 Census tract
census_block string Census block
cbsa cbsa Details
county county Details
school_district_elementary school_district Details
school_district_secondary school_district Details
congressional_district string 19th District
state_legislative_district_upper string District 26 Senate district
state_legislative_district_lower string District 85 House of Representatives district
police_jurisdiction police_jurisdiction Details
fire_jurisdiction fire_jurisdiction Details

entities:

Lists of amenities/features nearby the subject property

Name: Type: Example: Description:
schools array Details Nearby schools
fire_halls array Details Nearby fire halls
police_stations array Details Nearby police stations
medical_centers array Details Nearby medical centers
post_offices array Details Nearby post offices
points_of_interest array Details Nearby points of interest
parks array Details Nearby parks
libraries array Details Nearby libraries
museums array Details Nearby museums
natural array Details Nearby natural features

cbsa:

Name: Type: Example: Description:
name string

Philadelphia-Camden-Wilmington, PA-NJ-DE-MD Metropolitan Statistical Area

CBSA name
code integer 14500 CBSA code
type string msa Metropolitan or micropolitan statistical area

county:

Name: Type: Example: Description:
name string Onondaga County name
fips_code integer 84032 5 digit county FIPS code

school_district:

Name: Type: Example: Description:
id integer 3094 Unique ID of the district in our database
geoid string 609030
name string Clovis Unified School District Name of the school district
low_grade string PK Lowest grade level taught
high_grade string 12 Highest grade level taught
type string Unified One of 'Unified', 'Elementary', or 'Secondary'
latitude decimal 47.6195397
longitude decimal -122.349665
distance decimal Approximate distance from the target property, in kms

police_jurisdiction:

Name: Type: Example: Description:
name string Seattle Police Department Name of the police department
type string City Scope of the police department, 'City' or 'County'
city string Seattle City of a city-level police department
county_fips integer 33 County FIPS code
state_fips integer >53 State FIPS code
zipcode integer 98106

fire_jurisdiction:

Name: Type: Example: Description:
fdid string 50009 Fire department identifier
name string Ovid Fire Department
address string 2136 Brown St
address_2 string PO Box D
city string Ovid
zipcode integer 14521
county string Seneca
state string New York
phone string 607-869-5560
mailing_address string 2136 Brown St, Ovid, NY, 14521
department_type string Volunteer One of 'Career', 'Mostly Career', 'Volunteer', 'Mostly Volunteer'.
organization_type string Local
website string URL to department website
stations_count integer 1
career_firefighters_count integer 0
volunteer_firefighters_count integer 55
paid_per_call_firefighters_count integer 0
non_firefighting_staff_count integer 55
integererpolated_latitude decimal
integererpolated_longitude decimal

School data:

The list of schools contain the following data:

Name: Type: Example: Description:
name string George Washington High School name
type string Public Public/Private/Charter
level string Secondary Primary, Middle, Secondary, K-12, Post-secondary
district string Ohio School District 18
address string 123 Orchard City Way, Columbus, OH
latitude decimal 39.470741
longitude decimal -76.821693

Nearby entity data:

The remaining entities contain the following data:

Name: Type: Example: Description:
name string Foley Post Office Feature name
type string Post Office Feature type
latitude decimal 30.4060443
longitude decimal -87.6825713
distance decimal 6.37 Distance, in kms

Demographic components:

Name: Description:
metadata Information about the demographic data
population Array of population statistics
households Array of household statistics
housing Array of housing statistics

metadata:

Information about the demographic data

Name: Type: Example: Description:
level_returned string county Shows the level of the geographical hierarchy found
error_message string

Health components:

Name: Description:
metadata Information about the health data
life_expectancy Rows returned for each 5 year interval from 1985-2010
obesity Rows returned for years 2001, 2009, 2011
physical_activity Rows returned for years 2001, 2009, 2011
diabetes Rows returned for every year from 1999 to 2012
alcohol Rows returned for every year from 2005 to 2012

metadata:

Information about the health data

Name: Type: Example: Description:
level_returned string county Shows the level of the geographical hierarchy found
error_message string

Crime components:

Name: Description:
metadata Information about the crime data
aggregated_stats Rows returned for each crime type from the most recent year
events Rows returned with the most recent 25 events from the area.
sex_offenders Sex offenders in the given area. Maximum 100

metadata:

Information about the crime data

Name: Type: Example: Description:
level_returned string county Shows the level of the geographical hierarchy found
error_message string

Geohazard components:

Name: Description:
metadata Information about the geohazard data
natural_disaster_risk Rows returned for each crime type from the most recent year
storm_event Rows returned with the most recent 25 events from the area.

metadata:

Information about the geohazard data

Name: Type: Example: Description:
level_returned string county Shows the level of the geographical hierarchy found
error_message string