Skip to main content
POST
Query Parcels Post

Request format

Pass a filters array where each item specifies a field, an op (operator), and a value. All filters are AND’d together.
Use an array value for in, nin, and between:

Queryable fields

Text search fields: ilike, eq, ne, in, nin, isnull

ilike performs a case-insensitive substring match.
Queries on owner, parcel_id, situs, or mail_addr require a geographic scope. Include a state_fp, state, or county_fp filter.

Numeric fields: eq, ne, gt, gte, lt, lte, between, in, nin, isnull

ID and categorical fields: eq, ne, in, nin, isnull

Operators

Sorting

Pass an optional order object with a field and direction:

Pagination

Use limit (max 100, default 20) and offset to page through results.

Building footprints

Set include_buildings: true to include ORNL building footprint data for each parcel. When enabled, each parcel in the response will contain a buildings array with the physical structures on that parcel.
Each building includes geometry (geom), dimensions (sq_feet, sq_meters, height), occupancy classification, and address fields. The buildings key is omitted entirely when include_buildings is false (the default).

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
filters
FilterItem · object[]
required
Maximum array length: 10
order
OrderItem · object | null
limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: 0 <= x <= 10000
include_buildings
boolean
default:false

Response

Successful Response

results
Results · object[]
required
count
integer
required
limit
integer
required
offset
integer
required