Documentation menu
API reference

Parcels

Covers parcel and suggestion.

parcel

The county's land records: parcels found by address, number, point, area or id, with their owners, values, buildings, sales and boundaries.

The parcel object

What every call below returns, field by field.

objectalways list
datalist of objects
Show its fields
objectalways parcel
idtext
A parcel id.
numberobject
The primary identifier. Null when the issuer publishes none.
Show its fields
schemetext
The kind of identifier, as the issuer names it: apn, pin, cad_prop_id.
valuetext
The identifier, as published.
normalizedtext
The identifier in upper case with its spaces removed, which is what apn matches.
identifierlist of objects
Every current identifier under every scheme, primary first.
Show its fields
schemetext
The kind of identifier, as the issuer names it: apn, pin, cad_prop_id, cad_geo_id.
valuetext
The identifier, as published.
normalizedtext
The identifier in upper case with its spaces removed, which is what apn matches.
primarytrue or false
Whether this is the identifier the issuer keys the parcel by.
jurisdictionobject
The government that issued the number and holds the roll.
Show its fields
idtext
A jurisdiction id.
nametext
The common name.
typetext
The local word for the kind: county, parish, city.
fipstext
The Census GEOID. Null outside the US.
hreftext
The path of this jurisdiction.
withinlist of objects
The governments that contain the jurisdiction, largest tier first.
Show its fields
idtext
A jurisdiction id.
nametext
The common name.
tierone of national, region, subregion, local
One of national, region, subregion or local.
typetext
The local word for the kind: state, county, city.
fipstext
The Census GEOID. Null outside the US.
statustext
active.
typetext
The publisher's kind word for the parcel. Null when it publishes none.
areaobject
How big the parcel is. Null when the shape could not be measured.
Show its fields
sq_mnumber
The shape's area in square metres, measured from the boundary.
acresnumber
The shape's area in acres, measured from the boundary. What acres[gte] filters on.
stated_acresnumber
The area the roll states, the deeded or legal area, in acres. Null when the roll states none.
centroidobject
A point inside the shape. Null when there is no shape.
Show its fields
latnumber
Latitude.
lonnumber
Longitude.
addresslist of objects
The addresses on the parcel, situs first. Empty when the roll publishes none.
Show its fields
formattedtext
The one-line street address, as published.
numbertext
The house number. Null when the roll publishes none.
streettext
The street name, without its type. Null when the roll publishes none.
unittext
The unit. Null when there is none.
citytext
The postal city. Null when the roll publishes none.
statetext
The state, as a postal abbreviation. Null when the roll publishes none.
postal_codetext
The postal code. Null when the roll publishes none.
roletext
What the address is to the parcel: situs.
primarytrue or false
Whether this is the main address of several.
pointobject
Where the publisher placed the address. Null where it placed none.
Show its fields
latnumber
Latitude.
lonnumber
Longitude.
ownerlist of objects
The owners the roll names, in its order. Empty when it names none.
Show its fields
nametext
The owner's name, as the roll publishes it, even when it names several people.
kindtext
The publisher's class for the owner, or unknown.
orderinteger
The owner's position where the roll names several. Null when it names one.
mailing_addresstext
The mailing address on the roll. Null when it publishes none.
mailing_recipienttext
Who the mail goes to when that is someone other than the owner. Null otherwise.
accountlist of objects
The tax accounts assessed on the parcel, primary first.
Show its fields
numbertext
The account number, as the assessor writes it.
typetext
The kind of account: real_property.
tax_districttext
The tax or levy district, as published. Null when the roll publishes none.
assessortext
The assessor office, as the publisher names it. Null when the roll publishes none.
assessmentobject
The latest assessment. Null when the roll carries none.
Show its fields
tax_yearinteger
The year the values are assessed for.
classobject
The property class the assessor assigned. Null when the roll publishes none.
Show its fields
codetext
The code, as published.
descriptiontext
What the code means, as published. Null when the roll publishes none.
useobject
The use the assessor assigned. Null when the roll publishes none.
Show its fields
codetext
The code, as published.
descriptiontext
What the code means, as published. Null when the roll publishes none.
valueobject
The values, by basis. Null when the roll reports none.
Show its fields
marketobject
The market-basis values. Null when the roll reports none.
assessedobject
The assessed total. Null when the roll reports none.
taxableobject
The taxable total. Null when the roll reports none.
exemptionlist of objects
The exemptions on the assessment. Empty when there are none.
Show its fields
typetext
The kind of exemption, as the publisher names it.
codetext
The exemption code. Null when the roll publishes none.
descriptiontext
What the code means. Null when the roll publishes none.
amountnumber
The amount exempted. Null when unreported.
percentagenumber
The share exempted, 0 to 1. Null when unreported.
buildingobject
The main building the roll describes. Null when it describes none.
Show its fields
year_builtinteger
The year the building was first built. Null when unreported.
effective_year_builtinteger
The effective year built. Null when unreported.
building_area_sq_ftnumber
The gross building area in square feet. Null when unreported.
living_area_sq_ftnumber
The living area in square feet. Null when unreported.
storiesnumber
The number of stories. Null when unreported.
unit_countinteger
The number of units. Null when unreported.
bedroom_countnumber
The number of bedrooms. Null when unreported.
full_bath_countnumber
The number of full bathrooms. Null when unreported.
half_bath_countnumber
The number of half bathrooms. Null when unreported.
construction_typetext
The construction type, as published. Null when unreported.
condition_codetext
The condition code, as published. Null when unreported.
heating_typetext
The heating type, as published. Null when unreported.
saleobject
The latest sale the roll shows. Null when it shows none.
Show its fields
datedate
The sale date. Null when unreported.
recording_datedate
The date the deed was recorded. Null when unreported.
pricenumber
The price, in the roll's currency units. Null when the roll does not disclose it.
document_numbertext
The recorded document's number. Null when unreported.
deed_typetext
The kind of deed, as published. Null when unreported.
booktext
The deed book. Null when unreported.
pagetext
The deed page. Null when unreported.
codetext
The sale code, as published. Null when unreported.
grantortext
The seller, as published. Null when unreported.
legalobject
The legal description. Null when the roll publishes none.
Show its fields
descriptiontext
The legal description, as printed.
subdivisiontext
The subdivision. Null when unreported.
plat_nametext
The plat name. Null when unreported.
plat_booktext
The plat book. Null when unreported.
plat_pagetext
The plat page. Null when unreported.
blocktext
The block. Null when unreported.
lottext
The lot. Null when unreported.
sectiontext
The section. Null when unreported.
townshiptext
The township. Null when unreported.
rangetext
The range. Null when unreported.
geometryobject
The boundary as GeoJSON. Only with include=geometry, and null otherwise.
Show its fields
typetext
One of Polygon or MultiPolygon.
coordinateslist of value
Positions, nested to the depth the type implies.
matchobject
How a locator reached this parcel. Null on a filter or area read.
Show its fields
methodone of address, apn, point, id
What matched. One of address, apn, point or id.
scorenumber
How good the match is, 0 to 1. 1 is exact.
matchedtext
What it matched against, so an approximate match is inspectable.
as_ofdate
The date of the newest load that added or changed anything on this record.
hreftext
The path of this parcel.
has_moretrue or false
Whether another page follows this one.
next_cursortext
Pass as cursor for the next page. Null on the last page.
suppressedinteger
Rows that matched and were withheld, for example for a missing entitlement. Never silently zero: a withheld row is a fact about the answer.
totalobject
Only when total=true was asked for, and only on the first page.
Show its fields
valueinteger
relationone of eq, gte
'eq' is exact. 'gte' means there are at least this many; the count was capped.

Calls

suggestion

What a search box shows as a person types: governments, addresses and parcel numbers.

The suggestion object

What every call below returns, field by field.

objectalways list
datalist of objects
Show its fields
objectalways suggestion
kindone of address, parcel, jurisdiction
One of address, parcel or jurisdiction.
labeltext
What to show: the address, the parcel number, or the government's name.
detailtext
A second line that tells lookalikes apart: the county for an address or a number, the state for a county. Null when there is nothing to add.
queryobject
Parameters that reach the thing on GET /v1/parcel, or on GET /v1/jurisdiction for a government. Send them as they are.
hreftext
The path of the thing itself, where it already has one. Null for an address that reaches several parcels.
has_moretrue or false
Whether another page follows this one.
next_cursortext
Pass as cursor for the next page. Null on the last page.
suppressedinteger
Rows that matched and were withheld, for example for a missing entitlement. Never silently zero: a withheld row is a fact about the answer.
totalobject
Only when total=true was asked for, and only on the first page.
Show its fields
valueinteger
relationone of eq, gte
'eq' is exact. 'gte' means there are at least this many; the count was capped.

Calls

Next

GET /parcel

Search parcels