Documentation menu
API reference

Parcels

parcel

Parcels, with owners, assessed values, buildings, sales and boundaries. Search by address, parcel number, point or area.

The parcel object

objectstring
The object's type. Always parcel.
idstring
A parcel id.
numberobject
Primary parcel number. Null when not published.
Show fields
schemestring
Identifier scheme, such as apn, pin or cad_prop_id.
valuestring
The identifier, as published.
normalizedstring
The identifier in upper case, without spaces. The form apn matches against.
identifiersarray of objects
Every parcel identifier, primary first.
Show fields
schemestring
Identifier scheme, such as apn, pin, cad_prop_id or cad_geo_id.
valuestring
The identifier, as published.
normalizedstring
The identifier in upper case, without spaces. The form apn matches against.
primaryboolean
Whether this is the parcel's primary identifier, in number.
jurisdictionobject
The jurisdiction that assesses the parcel.
Show fields
idstring
A jurisdiction id.
namestring
The jurisdiction's common name.
typestring
Kind of jurisdiction, in local terms, such as county, parish, city or town.
fipsstring
The Census GEOID. Null outside the US.
hrefstring
The object's path in the API.
withinarray of objects
The jurisdictions that contain jurisdiction, largest first.
Show fields
idstring
A jurisdiction id.
namestring
The jurisdiction's common name.
tierone of national, region, subregion, local
Level of government. One of national, region (a state or province), subregion (a county or district) or local (a city, town, village or township).
typestring
Kind of jurisdiction, in local terms, such as county, parish, city or town.
fipsstring
The Census GEOID. Null outside the US.
statusstring
Parcel status. Always active.
typeobject
Parcel type, as published. Null when not published.
Show fields
codestring
Code, as published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardstring
Standard value, shared across jurisdictions. Null when not yet classified.
areaobject
Parcel size. Null when there is no boundary.
Show fields
sq_mnumber
Area in square meters, measured from the boundary.
acresnumber
Area in acres, measured from the boundary. Used by min_acres and max_acres.
stated_acresnumber
Deeded or legal area in acres, as published. Null when not published.
centroidobject
A point inside the boundary. Null when there is no boundary.
Show fields
latnumber
Latitude, in WGS 84.
lonnumber
Longitude, in WGS 84.
addressesarray of objects
Addresses on the parcel, main address first. Empty when none are published.
Show fields
rawstring
Full address on one line: every line it is published on, in order, joined with a comma.
recipientstring
Care-of or attention line, as published. Null when there is none.
street_line_1string
First street line: house number and street, or a PO box. Null when not published.
street_line_2string
Second street line: apartment, suite, unit or building. Null when there is none.
street_numberstring
House number. Null when not published.
street_namestring
Street name, without its type. Null when not published.
unitstring
Unit number. Null when there is none.
localitystring
City, town or village.
regionstring
State, as its two-letter abbreviation. Null when not published.
postal_codestring
ZIP or postal code. Null when not published.
pointobject
Location of the address point, as published. Null when not published.
Show fields
latnumber
Latitude, in WGS 84.
lonnumber
Longitude, in WGS 84.
rolestring
Address role. Always site, the address of the property itself.
primaryboolean
Whether this is the parcel's main address.
ownersarray of objects
Owners of record, in published order. Empty when none are published.
Show fields
namestring
Owner name, as published. One name can cover several people.
kindobject
Owner type, as published. Null when not published.
Show fields
codestring
Code, as published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardstring
Standard value, shared across jurisdictions. Null when not yet classified.
orderinteger
Position in the list of owners, as published. Null when there is one owner.
mailingobject
Mailing address, as published. Null when not published.
Show fields
rawstring
Full address on one line: every line it is published on, in order, joined with a comma.
recipientstring
Care-of or attention line, as published. Null when there is none.
street_line_1string
First street line: house number and street, or a PO box. Null when not published.
street_line_2string
Second street line: apartment, suite, unit or building. Null when there is none.
street_numberstring
House number. Null when not published.
street_namestring
Street name, without its type. Null when not published.
unitstring
Unit number. Null when there is none.
localitystring
City, town or village. Null when not published.
regionstring
State, as its two-letter abbreviation. Null when not published.
postal_codestring
ZIP or postal code. Null when not published.
pointobject
Location of the address point, as published. Null when not published.
Show fields
latnumber
Latitude, in WGS 84.
lonnumber
Longitude, in WGS 84.
assessmentobject
Latest assessment. Null when not published.
Show fields
tax_yearinteger
Tax year of the assessment. Null when not published.
classobject
Property class, as assigned by the assessor. Null when not published.
Show fields
codestring
Code, as published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardenum
Land use, shared across jurisdictions: a category, or a category and a kind joined by a dot. Null when the code is not classified.
Show possible values
residential
Residential. LBCS activity 1000.
residential.single_family
Single family. LBCS activity 1100.
residential.multi_family
Multifamily, two or more units in one building. LBCS activity 1100.
residential.condominium
Condominium unit. LBCS activity 1100.
residential.mobile_home
Mobile or manufactured home. LBCS activity 1100.
residential.common_area
Common area of a subdivision or condominium. LBCS activity 1000.
commercial
Commercial. LBCS activity 2000.
commercial.retail
Retail. LBCS activity 2100.
commercial.office
Office. LBCS activity 2300.
commercial.lodging
Hotel or motel. LBCS activity 1200.
commercial.recreation
Commercial recreation, such as a golf course or marina. LBCS activity 7000.
commercial.parking
Parking lot or garage. LBCS activity 5210.
industrial
Industrial. LBCS activity 3000.
industrial.manufacturing
Manufacturing. LBCS activity 3110.
industrial.warehouse
Warehouse or distribution. LBCS activity 3120.
industrial.mining
Mining or quarry. LBCS activity 8600.
agricultural
Agricultural. LBCS activity 8000.
agricultural.timber
Timber or forest. LBCS activity 8400.
vacant
Vacant land. LBCS activity 9000.
vacant.residential
Vacant residential land. LBCS activity 9000.
vacant.commercial
Vacant commercial land. LBCS activity 9000.
vacant.industrial
Vacant industrial land. LBCS activity 9000.
institutional
Institutional. LBCS activity 4000.
institutional.government
Government, including public parks. LBCS activity 4000.
institutional.religious
Religious. LBCS activity 6600.
institutional.education
School or college. LBCS activity 4100.
institutional.health
Hospital or care facility. LBCS activity 4500.
institutional.cemetery
Cemetery. LBCS activity 4600.
open_space
Open space. LBCS activity 9000.
open_space.conservation
Conservation land, preserve or easement. LBCS activity 9000.
open_space.water
Water, submerged land or wetland. LBCS activity 9000.
open_space.recreation
Recreation land that is not a business, such as a hunting camp. LBCS activity 7200.
utility
Utility, transportation or right of way. LBCS activity 4300.
mixed
Mixed residential and commercial use. No LBCS activity.
exempt
Exempt from tax, use not stated. No LBCS activity.
mineral_rights
Mineral or subsurface rights, with no surface. LBCS activity 9300.
useobject
Land use, as assigned by the assessor. Null when not published.
Show fields
codestring
Code, as published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardenum
Land use, shared across jurisdictions: a category, or a category and a kind joined by a dot. Null when the code is not classified.
Show possible values
residential
Residential. LBCS activity 1000.
residential.single_family
Single family. LBCS activity 1100.
residential.multi_family
Multifamily, two or more units in one building. LBCS activity 1100.
residential.condominium
Condominium unit. LBCS activity 1100.
residential.mobile_home
Mobile or manufactured home. LBCS activity 1100.
residential.common_area
Common area of a subdivision or condominium. LBCS activity 1000.
commercial
Commercial. LBCS activity 2000.
commercial.retail
Retail. LBCS activity 2100.
commercial.office
Office. LBCS activity 2300.
commercial.lodging
Hotel or motel. LBCS activity 1200.
commercial.recreation
Commercial recreation, such as a golf course or marina. LBCS activity 7000.
commercial.parking
Parking lot or garage. LBCS activity 5210.
industrial
Industrial. LBCS activity 3000.
industrial.manufacturing
Manufacturing. LBCS activity 3110.
industrial.warehouse
Warehouse or distribution. LBCS activity 3120.
industrial.mining
Mining or quarry. LBCS activity 8600.
agricultural
Agricultural. LBCS activity 8000.
agricultural.timber
Timber or forest. LBCS activity 8400.
vacant
Vacant land. LBCS activity 9000.
vacant.residential
Vacant residential land. LBCS activity 9000.
vacant.commercial
Vacant commercial land. LBCS activity 9000.
vacant.industrial
Vacant industrial land. LBCS activity 9000.
institutional
Institutional. LBCS activity 4000.
institutional.government
Government, including public parks. LBCS activity 4000.
institutional.religious
Religious. LBCS activity 6600.
institutional.education
School or college. LBCS activity 4100.
institutional.health
Hospital or care facility. LBCS activity 4500.
institutional.cemetery
Cemetery. LBCS activity 4600.
open_space
Open space. LBCS activity 9000.
open_space.conservation
Conservation land, preserve or easement. LBCS activity 9000.
open_space.water
Water, submerged land or wetland. LBCS activity 9000.
open_space.recreation
Recreation land that is not a business, such as a hunting camp. LBCS activity 7200.
utility
Utility, transportation or right of way. LBCS activity 4300.
mixed
Mixed residential and commercial use. No LBCS activity.
exempt
Exempt from tax, use not stated. No LBCS activity.
mineral_rights
Mineral or subsurface rights, with no surface. LBCS activity 9300.
valueobject
Values, by basis. Null when not published.
Show fields
marketobject
Market values. Null when not published.
Show fields
landnumber
Land value. Null when not published.
improvementnumber
Improvement value. Null when not published.
totalnumber
Total market value. Null when not published.
assessedobject
Assessed value. Null when not published.
Show fields
totalnumber
Total value. Null when not published.
taxableobject
Taxable value. Null when not published.
Show fields
totalnumber
Total value. Null when not published.
exemptionsarray of objects
Tax exemptions. Empty when there are none.
Show fields
typestring
Exemption type, as published. Null when not published.
codestring
Exemption code, as published. Null when not published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardstring
Standard value, shared across jurisdictions. Null when not yet classified.
amountnumber
Amount exempted, in US dollars. Null when not published.
percentagenumber
Share exempted, between 0 and 1. Null when not published.
buildingsarray of objects
Buildings on the parcel, main building first. Empty when none are published.
Show fields
building_numberstring
Building or card number on the parcel, as published. Null when not published.
typestring
Building type, as published. Null when not published.
descriptionstring
Building description, as published. Null when not published.
use_codestring
Building use code, as published. Null when not published.
valuenumber
Market value of the building, in US dollars. Null when not published.
year_builtinteger
Year built. Null when not published.
effective_year_builtinteger
Effective year built, after major renovation. Null when not published.
building_area_sq_ftnumber
Gross building area, in square feet. Null when not published.
living_area_sq_ftnumber
Living area, in square feet. Null when not published.
storiesnumber
Number of stories. Null when not published.
unit_countinteger
Number of units. Null when not published.
bedroom_countnumber
Number of bedrooms. Null when not published.
full_bath_countnumber
Number of full bathrooms. Null when not published.
half_bath_countnumber
Number of half bathrooms. Null when not published.
construction_typestring
Construction type, as published. Null when not published.
quality_codestring
Construction quality code, as published. Null when not published.
quality_descriptionstring
Construction quality, as published. Null when not published.
condition_codestring
Condition code, as published. Null when not published.
condition_descriptionstring
Condition, as published. Null when not published.
garage_typestring
Garage type, as published. Null when not published.
basement_typestring
Basement type, as published. Null when not published.
fireplaceboolean
Whether the building has a fireplace. Null when not published.
percent_completenumber
Share of construction complete, as a percentage. Null when not published.
heating_typestring
Heating type, as published. Null when not published.
stylestring
Building style, as published. Null when not published.
room_countnumber
Number of rooms. Null when not published.
bath_countnumber
Number of bathrooms, with a half bath counted as 0.5. Null when not published.
exterior_wallstring
Exterior wall material, as published. Null when not published.
roof_coverstring
Roof covering, as published. Null when not published.
roof_typestring
Roof shape, as published. Null when not published.
foundation_typestring
Foundation type, as published. Null when not published.
cooling_typestring
Cooling type, as published. Null when not published.
heating_fuelstring
Heating fuel, as published. Null when not published.
fireplace_countnumber
Number of fireplaces. Null when not published.
garage_area_sq_ftnumber
Garage area, in square feet. Null when not published.
basement_area_sq_ftnumber
Basement area, in square feet. Null when not published.
basement_finished_area_sq_ftnumber
Finished basement area, in square feet. Null when not published.
year_remodeledinteger
Year of the last remodel. Null when not published.
salesarray of objects
Recorded sales of the parcel, most recent first. Empty when none are published.
Show fields
datedate
Sale date. Null when not published.
monthstring
Month of the sale, as YYYY-MM. Set wherever date is, and on its own where only the month is published. Null when not published.
recording_datedate
Recording date of the deed. Null when not published.
pricenumber
Sale price, in US dollars. Null when not disclosed.
document_numberstring
Recorded document number. Null when not published.
deed_typeobject
Deed type. Null when not published.
Show fields
codestring
Code, as published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardstring
Standard value, shared across jurisdictions. Null when not yet classified.
bookstring
Deed book. Null when not published.
pagestring
Deed page. Null when not published.
qualificationobject
Sale qualification, such as arm's length, as published. Null when not published.
Show fields
codestring
Code, as published.
descriptionstring
Meaning of the code, as published. Null when not published.
standardstring
Standard value, shared across jurisdictions. Null when not yet classified.
grantorstring
Seller, as published. Null when not published.
granteestring
Buyer, as published. Null when not published.
transfer_taxnumber
Transfer tax paid on the deed, in US dollars. Null when not published.
vacant_landboolean
Whether the land was vacant at the sale. Null when not published.
new_constructionboolean
Whether the sale was of new construction. Null when not published.
deed_referencestring
Deed book and page, printed as one reference. Null when not published.
document_urlstring
Link to the recorded deed. Null when not published.
legalobject
Legal description. Null when not published.
Show fields
descriptionstring
Full legal description, as published.
subdivisionstring
Subdivision name. Null when not published.
plat_namestring
Plat name. Null when not published.
plat_bookstring
Plat book. Null when not published.
plat_pagestring
Plat page. Null when not published.
blockstring
Block. Null when not published.
lotstring
Lot. Null when not published.
sectionstring
Section, in the public land survey. Null when not published.
townshipstring
Township, in the public land survey. Null when not published.
rangestring
Range, in the public land survey. Null when not published.
geometryobject
Boundary, as GeoJSON. Included only with include=geometry; null otherwise.
Show fields
typestring
Geometry type. One of Polygon or MultiPolygon.
coordinatesarray of anys
Coordinates, as [longitude, latitude] positions nested by geometry type.
matchobject
How the search matched this parcel. Null unless the request used address, apn, lat with lon, or an id.
Show fields
methodone of address, apn, point, id
Match method. One of address, apn, point or id.
scorenumber
Match confidence, between 0 and 1. 1 is exact. For an address, 1 means the house number, street name, street type, direction, and any unit, city and ZIP code sent all agree.
matchedstring
The value matched against, such as the parcel's address. Null when not applicable.
as_ofdate
Date of the most recent update to this parcel.
hrefstring
The object's path in the API.

Endpoints

suggestion

Matches for typed text, for search-as-you-type: jurisdictions, addresses and parcel numbers.

The suggestion object

objectstring
The object's type. Always suggestion.
kindone of address, parcel, jurisdiction
Kind of match. One of address, parcel or jurisdiction.
labelstring
Display text: the address, parcel number or jurisdiction name.
detailstring
Secondary display text, such as the county for an address or the state for a county. Null when not needed.
queryobject
Query parameters for GET /v1/parcel, or GET /v1/jurisdiction for a jurisdiction. Send them unchanged.
hrefstring
The matched object's path in the API. Null for an address that matches several parcels.

Endpoints

Next steps

GET /parcel

Search parcels

Continue