POST /v1/permits/parcels returns one row per parcel that has permits tied to it.
Use it to:
- find the parcels in a county with recent work of one kind;
- read the permit summary of up to 100 parcels you already know.
- Each row returned costs one permit row: $0.012 on Free, $0.0086 on Build and $0.0072 on Growth. See Pricing.
- A call that returns no row is free, including a count (
limit: 0). - It needs accepted terms and licensed access with the
earth.searchscope, the same as a permits search. See Authentication.
Example: parcels with a solar permit since 2025
mireye_permits_parcels. Send the same body inside req:
Request
- Any other key is rejected with
422. withoutis not supported yet: it is rejected with422 not_yet_supported.
where
Send one of:-
{"state": "TX", "county_fips": "48157"}: the parcels in one county.county_fipsis five digits and must be instate. -
{"parcels": ["…", "…"]}: 1 to 100 parcel ids, each a lowercase UUID such as"11111111-2222-3333-4444-555555555555". Get them fromparcel.parcel_idof a permit record, or from Enrich or Search. - A parcel with no counted permit has no row.
- With a list of parcels, a parcel may be missing from the rows. Then it has no counted permit, or its office is not fully collected.
-
Read
coveragebefore you treat it as “no permits”.
with
A parcel is kept when at least one of its counted permits matches every part you send:
Values are the Permits API vocabulary. An unknown
value is rejected with the nearest valid values.
filters
filters narrows which permits are counted in each row. The row’s counts, dates and
tags then cover only those permits. These keys work, with the same meaning as in a
permits search:
date_field, date_from, date_to, status, category, work_tags, tags_match,
min_date_precision and include_reissued.
Any other filter is rejected with 422 permits_filter_unsupported. Its filters key
lists the filters that cannot be used.
Which permits count
A permit counts for a parcel by the same rule as the Enrich permit fields:- It is tied to the parcel with
highormediumlink confidence. - It has a day, month or year date.
- It is not undated and not an older history record.
filters, a row’s
permit_count, latest_date and tags equal the Enrich permit fields for that
parcel.
Response
Row
Paging
- Send
next_cursorascursorwith the same body.limitandmax_cost_usdmay change. - A cursor expires after one hour, or when the permit data is refreshed. Then the
answer is
422 permits_cursor_expired: start again without a cursor. - Each page is a new paid call with its own
Idempotency-Key.
Price
- One permit row for each row returned.
- The most it can cost,
limitrows, is reserved first. Setmax_cost_usdat or above it. - A call with no row is free:
- a count (
limit: 0); - no matching parcel;
- a call that fails.
- a count (
- Send a stable
Idempotency-Keyto retry without a second charge. See Retries.
Errors
The other errors are the same as a permits search. See
Errors.
Related pages
- Permits API: the permit records themselves.
- Permits stats: counts grouped by month, tag, category or office.
- Enrich permit fields: the same counts for one parcel.
- Permits known issues.