Property V3

Search properties by address or APN

Changed on

Search properties by address or by Assessor's Parcel Number.

Returns a page of results ordered by how well each matches, with the person lists trimmed and a count of what was held back. Each result links to its full record on the details endpoint.

An APN names a parcel rather than describing an address, so an APN search reports no match classification and ignores strict_match. state_code or fips narrows it to one county; a state that does not contain the parcel matches nothing rather than falling back to the number alone. fips narrows an address search the same way.

Supplying lat and lng bounds the search to radius miles of that point and orders the results by distance, each carrying its distance_miles. Address components narrow that set further rather than competing with it. A parcel number names one property outright, so it combines with neither.

Nothing matching is a 404 carrying an empty results array, so a caller parses one shape either way. It does not bill.

A search that filters on strict_match or orders by distance decides both over the first 200 candidates, so every page of one query describes one qualifying set in one order rather than one that shifts with the page asked for. Results past that window are not reachable, and result_count is held down to what it reaches. A search that neither filters nor reorders pages the index directly and sees no such window.

result_count saturates at 10,000. A broad query reports that figure rather than a true total, and results past it are not reachable by paging, so narrow the address to reach them.

get/v3/property/

Request

Query parameters

streetstring nullable

Street address line

Example:1301 5th Ave
citystring nullable

City name

Example:Seattle
state_code'AL' | 'AK' | 'AZ' | 'AR' | 'AS' | 'CA' | 'CO' | 'CT' | 'DE' | 'DC' | 'FL' | 'GA' | 'GU' | 'HI' | 'ID' | 'IL' | 'IN' | 'IA' | 'KS' | 'KY' | 'LA' | 'ME' | 'MD' | 'MA' | 'MI' | 'MN' | 'MS' | 'MO' | 'MT' | 'NE' | 'NV' | 'NH' | 'NJ' | 'NM' | 'NY' | 'NC' | 'ND' | 'MP' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'TT' | 'UT' | 'VT' | 'VA' | 'VI' | 'WA' | 'WV' | 'WI' | 'WY'

Valid US State and Territory codes.

This enum contains all valid two-letter codes for US states and territories. Used for parameter validation in API requests.

Two-letter state code

zipcodestring nullable

Five-digit ZIP code

Example:98101
apnstring nullable

Assessor's Parcel Number. Unique within a county rather than nationally, so it can match several properties. Cannot be combined with address parameters.

Example:197470-0025
fipsstring nullable

Five-digit county FIPS code. Narrows the search to one county, whether it names a parcel number or an address.

Example:17031
latnumber nullable

Latitude of a point to search around. Supply with lng

Example:47.607958
lngnumber nullable

Longitude of a point to search around. Supply with lat

Example:-122.337202
radiusnumber nullable

Radius around the geopoint in miles, defaulting to 1

Example:0.5
strict_matchboolean nullable

Keep only results that are the address supplied or an address in the same building

pageinteger

One-based page number

page_sizeinteger

Results per page

Response

Properties retrieved successfully

Changes