Skip to main content
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.search scope, the same as a permits search. See Authentication.

Example: parcels with a solar permit since 2025

Values are illustrative. Over hosted MCP, the tool is mireye_permits_parcels. Send the same body inside req:

Request

  • Any other key is rejected with 422.
  • without is not supported yet: it is rejected with 422 not_yet_supported.

where

Send one of:
  • {"state": "TX", "county_fips": "48157"}: the parcels in one county. county_fips is five digits and must be in state.
  • {"parcels": ["…", "…"]}: 1 to 100 parcel ids, each a lowercase UUID such as "11111111-2222-3333-4444-555555555555". Get them from parcel.parcel_id of 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 coverage before 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 high or medium link confidence.
  • It has a day, month or year date.
  • It is not undated and not an older history record.
One job filed as several linked records counts once. With no filters, a row’s permit_count, latest_date and tags equal the Enrich permit fields for that parcel.

Response

Row

Paging

  • Send next_cursor as cursor with the same body. limit and max_cost_usd may 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, limit rows, is reserved first. Set max_cost_usd at or above it.
  • A call with no row is free:
    • a count (limit: 0);
    • no matching parcel;
    • a call that fails.
  • Send a stable Idempotency-Key to retry without a second charge. See Retries.

Errors

The other errors are the same as a permits search. See Errors.