Query parcels

POST /parcels/query

Query Parcels Post

cURL

curl --request POST \
  --url https://api.buyparceldata.com/parcels/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "field": "<string>",
      "op": "<string>",
      "value": "<string>"
    }
  ],
  "order": {
    "field": "<string>",
    "direction": "asc"
  },
  "limit": 20,
  "offset": 0,
  "include_buildings": false
}
'

200

{
  "results": [
    {}
  ],
  "count": 123,
  "limit": 123,
  "offset": 123
}

Request format

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

{
  "filters": [
    { "field": "owner", "op": "ilike", "value": "SMITH" },
    { "field": "state", "op": "eq", "value": "CA" }
  ],
  "limit": 20,
  "offset": 0
}

Use an array value for in, nin, and between:

{
  "filters": [
    { "field": "state", "op": "in", "value": ["CA", "OR", "WA"] },
    { "field": "acres", "op": "between", "value": [500, 10000] }
  ]
}

Queryable fields

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

ilike performs a case-insensitive substring match.

Field	Description
owner	Owner name
parcel_id	County assessor parcel ID (APN)
situs	Property address
mail_addr	Owner mailing address
city	City
land_use	Land use classification
land_use_code	Land use code
legal	Legal description
cdl_majority_category	USDA crop/land cover type (e.g. Corn, Soybeans)

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

Field	Description
acres	Parcel area (county-reported)
acres_calc	Parcel area (calculated from geometry)
parcel_value	Total assessed value (USD)
land_value	Land assessed value (USD)
improvements_value	Improvements assessed value (USD)
agricultural_value	Agricultural assessed value (USD)
building_value	Building assessed value (USD)
sale_price	Most recent sale price (USD)
tax_amount	Annual property tax (USD)
elevation	Centroid elevation (meters)
adjacent_acreage_sameowner	Contiguous acreage under same ownership
cdl_majority_value	Numeric CDL category code
cdl_majority_percent	% of parcel covered by majority CDL category
sq_feet	Parcel area in square feet

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

Field	Description
state_fp	State FIPS code (e.g. "19" for Iowa)
state	Two-letter state abbreviation (e.g. "IA")
county_fp	County FIPS code
county	County name
postal	ZIP code
zoning	Zoning code
owner_type	Owner type
sale_date	Sale date string
bpd_uuid	BPD UUID; use in to batch-fetch records from an area search
bpd_stack_uuid	Stack UUID for grouped same-location parcels

Operators

Operator	Description	Value type
eq	Equals	string or number
ne	Not equals	string or number
gt / gte	Greater than (or equal)	number
lt / lte	Less than (or equal)	number
between	Inclusive range	2-element array: [min, max]
in	In set	array of strings or numbers
nin	Not in set	array of strings or numbers
ilike	Case-insensitive substring match	string
isnull	Is null / is not null	true (null) or false (not null)

Sorting

Pass an optional order object with a field and direction:

{
  "filters": [{ "field": "state_fp", "op": "eq", "value": "19" }],
  "order": { "field": "acres", "direction": "desc" }
}

Pagination

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

{
  "filters": [
    { "field": "state_fp", "op": "eq", "value": "19" },
    { "field": "acres", "op": "gte", "value": 100 }
  ],
  "limit": 100,
  "offset": 200
}

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.

{
  "filters": [{ "field": "state_fp", "op": "eq", "value": "06" }],
  "include_buildings": true
}

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

Show child attributes

order · OrderItem · object

Show child attributes

limit · integer · default: 20

Required range: 1 <= x <= 100

offset · integer · default: 0

Required range: 0 <= x <= 10000

include_buildings · boolean · default: false

Response

200

application/json

Successful Response

results · Results · object[] · required

count · integer · required

limit · integer · required

offset · integer · required