Property Data API Schema

API Schema

Property Components:

Name: Description:
metadata Metadata about the property
addresses An array of address objects containing details on the address(es) for the property
geocoding Geocoding details for the property
parcel Details on the land parcel
land_use Details on the zoning and urban planning land use for the property
structures Array of all structures recorded on the land parcel
structure_totals Feature totals across all structures on the property
owners Array of all current and previous owners on file
assessments Array of all tax assessments on file
sales Array of all sales records on file
mortgages Array of all mortgage records on file
legal Legal details of the property
valuation Computed valuation and estimates for the property
status Information about the current residency and market status of the property
postal USPS information for the property
geographies Geography information for the property

metadata:

Metadata about the property.

Name: Type: Example: Description:
property_id integer 32452 Unique identifier for the property in our database
upi string US-06037-N-4328031029-R-N Unique property identifier
published_at datetime 2015-08-18 The date the most recent public data we are using was published
updated_at datetime 2018-09-28 Last update timestamp. Please note that data is frequently refreshed, but this timestamp represents when the last change was made. This change could be to any element of the record, but does not necessarily mean that all fields were refreshed.
release_version string v57.2 API release version number. Fixes and improvements will increment it, but no changes will be made to the schema.

addresses:

An array of address objects containing details on the address(es) for the property.

Name: Type: Example: Description:
street_number string 1651 Standardized and parsed street number
street_pre_direction string N Standardized and parsed street direction
street_name string Dayton Standardized and parsed street name
street_suffix string St Standardized and parsed street suffix
street_post_direction string N Standardized and parsed street direction
unit_number string 101 Unit number of subject property
formatted_street_address string 101 1651 N Dayton St Combined street address
city string Chicago Standard and parsed city
state string IL State abbreviation
zip_code string 60614 Zip code
zip_code_plus_four string 5505 Zip code plus 4

geocoding:

Geocoding details for the property.

Name: Type: Example: Description:
street object A geocoding object
parcel_centroid object A geocoding object
rooftop object A geocoding object

geocoding.street, geocoding.parcel_centroid, geocoding.rooftop:

Geocoding information on the property.

Name: Type: Example: Description:
latitude decimal 41.912406 Measured latitude for the property
longitude decimal -87.649191 Measured longitude for the property

parcel:

Details on the land parcel.

Name: Type: Example: 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 East-West axis boundary value
township string 10N North-South axis boundary value
section string 34 A township/range can be divided further into 36, 1-mile sections. This is the corresponding section number
block string 019 Plats are divided up into blocks. This is the corresponding block number.
lot string 008 Blocks are divided up into lots. This is the corresponding lot number.
location_description string City Description of the location
building_count integer 1 Number of buildings on the property
boundaries object A boundaries object

parcel.boundaries:

Boundary data on the property.

Name: Type: Example: Description:
srid integer 4326 Spatial reference identifier used to locate geographical entities
wkt string POLYGON((-118.400744 34.064134,-118.400744 34.063983,-118.401165 34.063983,-118.401165 34.064134,-118.400744 34.064134)) Boundaries in Well-Known Text format
geojson object A geojson object

parcel.boundaries.geojson:

GeoJSON information on the property.

Name: Type: Example: Description:
type string Polygon Geometry type of the property boundary
coordinates decimal [ [ [ -118.400744, 34.064134 ], [ -118.400744, 34.063983 ], [ -118.401165, 34.063983 ], [ -118.401165, 34.064134 ], [ -118.400744, 34.064134 ] ] ] Coordinates provided in geoJSON format

land_use:

Details on the zoning and urban planning land use for the property.

Name: Type: Example: Description:
classification_code string RSF0115 Code that breaks down to say residential, single family, less than 1000 sq ft
category string Residential Land use category
subcategory string Single Family Residence Land use description
source_code string 1320 The original county or city land use code
zoning string RU6 Urban planing zoning designation

structures:

Array of all structures recorded on the land parcel.

Name: Type: Example: Description:
is_primary boolean true Indicates whether this record is for the primary structure
year_built integer 1923
effective_year_built integer 1996 The year a structure was substantially updated
identifier string BN23456XY Source-assigned identifier
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
height integer 20 Height of structure in feet
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 Single Family
condition string Excellent Current condition 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
quality string Excellent Quality of construction of the buildings
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

structure_totals:

Feature totals across all structures on the property.

Name: Type: Example: Description:
beds integer 6 Total bed count for all structures on parcel
baths integer 5 Total bath count for all structures on parcel
rooms integer 16 Total room count for all structures on parcel
units integer 30 Total number of units on the property
sq_ft integer 1692 Total square footage for all structures on parcel
count integer 2 Total counts for features across all structures on parcel

owners:

Array of all current and previous owners on file.

Name: Type: Example: Description:
corporate_flag boolean false Corporate ownership indicator
name string Smith John Full name of owner
second_name string Smith Jane Name of second owner
address string 220 S Rodeo Dr
city string Beverly Hills
state string CA
zip_code string 90212
first_name string John Owner first name
middle_name string Owner middle name
last_name string Smith Owner last name
suffix string Mr. Suffix of owner
ended_at date 2016-07-25 Date ownership relinquished
started_at date 2013-01-01 Date ownership started

assessments:

Array of all tax assessments on file.

Name: Type: Example: Description:
land integer 1743 Assessed land value
improvement integer 5079 Assessed improvement value
total integer 6933 Total assessed value
exemptions array [] Array of exemptions
tax_amount integer 705 Tax amount
tax_year integer 2016 Tax year
details array [] Extra details
outstanding_tax decimal 233.16 Unpaid tax
appraised_land integer 2200 Appraised land value
appraised_improvement integer 6250 Appraised improvement value
appraised_total integer 8450 Total appraised value

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
type string Deed of Trust
seller string Smith John & Jane Seller name
buyer string Mohr Ben Buyer name
transaction_id string 102908883
document_year integer 2009
sale_code string Sale Price (Full) Additional sale status information
multi_apn boolean false This sale involved multiple parcels (such as a merge or split)
hpi_adjusted_price_2010 integer 176000 Sale price, adjusted to 2010 dollars
deed_book string
deed_page string
document_id integer 0000093154

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
date date 2009-08-24 Date document recorded
term integer 360 Length of mortgage in months
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

Legal details of the property.

Name: Type: Example: Description:
apn_original string 12345678
apn_unformatted string 12345678
tax_account string 123-456-78
legal_description string
planned_urban_development string

valuation:

Computed valuation and estimates for the property.

Name: Type: Example: Description:
value integer 189000
low integer 178000 The lowest price this property should yield in a sale
high integer 201000 The highest price this property should yield in a sale
confidence decimal 0.90 Confidence level for the low-high confidence interval
market_value_change_year decimal 12.5 Percentage change in property value since the last calendar year
market_value_change_quarter decimal 3.6 Percentage change in property value since the previous quarter
forecast_1_year decimal 196000 Forecasted valuation value in one year
suggested_rental integer 1250 Estimated monthly market rental rate

status:

Information about the current residency and market status of the property.

Name: Type: Example: Description:
absentee_owner boolean false Whether the owner resides in the property or not
vacant boolean false True if the property has been vacant for 90 days or more
market_status string For sale Current market status (for sale, recently sold, etc)
rental_price decimal 1425.00 Price that property is currently being rented at

postal:

USPS information for the property.

Name: Type: Example: Description:
carrier_code string R001
delivery_point_code integer 17
delivery_point_check_digit integer 6
validated boolean true This address corresponds to a USPS record.
deliverable string Y This address can receive mail.

geographies:

Name: Type: Example: Description:
congressional string 6th District The property belongs to this congressional district
neighborhood string Tenderloin district The property belongs to this neighborhood
Name: Description:
county County details
census Census details
cbsa Core-based statistical area information for the property
school_elementary Information regarding the elementary school in the property's district
school_secondary Information regarding the secondary school in the property's district
state_legislative_upper Information about the State Legislative Upper House
state_legislative_lower Information about the State Legislative Lower House
police Information about the police department that services the property's district
fire Information about the fire department that services the property's district
flood Flood risk information on the property

geographies.county:

County details

Name: Type: Example: Description:
name string Orange
state_fips_code string 06 Unique state identifier
fips_code string 059 Unique county identifier

geographies.census:

Census details

Name: Type: Example: Description:
census_tract integer 87602
census_block string 3004

geographies.cbsa:

Core-based statistical area information for the property

Name: Type: Example: Description:
name string Colorado Springs, CO CBSA name
code string 17820
type string MSA Metropolitan or micropolitan statistical area

geographies.school_elementary:

Information regarding the elementary school in the property's district

Name: Type: Example: Description:
geoid string 623430 Unique geography identifier
name string Magnolia Elementary School District
low_grade string KG Initial grade level
high_grade string 6 Final grade level
type string Elementary

geographies.school_secondary:

Information regarding the secondary school in the property's district

Name: Type: Example: Description:
geoid string 602630 Unique geography identifier
name string Anaheim Union High School District
low_grade string 7 Initial grade level
high_grade string 12 Final grade level
type string Secondary

geographies.state_legislative_upper:

Information about the State Legislative Upper House

Name: Type: Example: Description:
name string State Senate District 34 State Legislative Upper House district

geographies.state_legislative_lower:

Information about the State Legislative Lower House

Name: Type: Example: Description:
name string Assembly District 65 State Legislative Lower House district

geographies.police:

Information about the police department that services the property's district

Name: Type: Example: Description:
name string Anaheim Police Department
type string City
city string Anaheim
state_fips string 06
county_fips string 102

geographies.fire:

Information about the fire department that services the property's district

Name: Type: Example: Description:
fdid string CS931 Fire department identifier
name string Chicago Fire Department
address string 10 W 35TH ST
address_2 string Floor 14
city string Chicago
zip_code string 60616
phone string 312-745-3705
mailing_address string 10 W 35TH ST, Floor 14, Chicago, IL, 60616
department_type string Career
organization_type string Local
website string Official website of the fire department
stations_count integer 100
career_firefighters_count integer 4881
volunteer_firefighters_count integer 0
paid_per_call_firefighters_count integer 0
non_firefighting_staff_count integer 0
interpolated_latitude decimal
interpolated_longitude decimal
county string Cook
state string Illinois

geographies.flood:

Flood risk information on the property

Name: Type: Example: Description:
fima_flood_zone string X https://www.fema.gov/flood-zones
annual_flood_risk string AREA OF MINIMAL FLOOD HAZARD
firm_panel_id string 24015C