---
title: "Query Permits"
method: POST
path: "/v1/permits/query"
---

# Query Permits

`POST /v1/permits/query`

## Request

- Base URL: `https://api.parcelapi.net`
- URL: `https://api.parcelapi.net/v1/permits/query`
- Auth: API key in header `X-API-Key`

Building permits from cleared sources. 1 credit per record; blocklist applies; attribution returned.

## Request body

- PermitFilter
  - `state` string, required: 2-letter US state code
  - `city` string, nullable
  - `county` string, nullable
  - `address` string, nullable
  - `permit_type` string, nullable
  - `issued_after` string, nullable
  - `issued_before` string, nullable
  - `limit` integer
  - `offset` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/parcelapi/apis/parcelapi-net-api.md) · [All operations](https://skmtc.dev/parcelapi/apis/parcelapi-net-api/llms.txt) · [OpenAPI document](https://skmtc.dev/parcelapi/apis/parcelapi-net-api/revisions/428ee6d02c75?raw)