Thousands of permit portals. One schema. One API key.

# Filter structured records. Every parameter is optional.
curl -H "X-API-Key: $EXHAUST_API_KEY" \
  "https://permitsapi.com/api/v1/records?\
jurisdiction=City+of+Seattle&\
work_class=roofing&\
issued_after=2025-01-01&\
min_valuation=10000&\
order_by=issued_date&\
limit=50"

# Same query, same filters, as a spreadsheet.
curl -H "X-API-Key: $EXHAUST_API_KEY" -H "Accept: text/csv" \
  "https://permitsapi.com/api/v1/records?state=WA&work_class=roofing" \
  -o wa-roofing.csv

# Pull only what changed since your last sync.
curl -H "X-API-Key: $EXHAUST_API_KEY" \
  "https://permitsapi.com/api/v1/records?\
updated_since=2025-09-01T00:00:00Z&limit=200"

# Natural language in, ranked records out. No embedding cost on your side.
curl -X POST "https://permitsapi.com/api/v1/records/search" \
  -H "X-API-Key: $EXHAUST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "rooftop solar installs over $25k",
    "state": "WA",
    "issued_after": "2025-01-01",
    "limit": 10
  }'

{
  "data": [
    {
      "permit_number": "6912345-CN",
      "work_description": "Install 8.2kW rooftop PV",
      "similarity": 0.891,
      "chunk_text": "Building Permit in City of Seattle…"
    }
  ],
  "returned": 10,
  "took_ms": 38
}

import os, httpx

client = httpx.Client(
    base_url="https://permitsapi.com/api/v1",
    headers={"X-API-Key": os.environ["EXHAUST_API_KEY"]},
    timeout=30,
)

# Page through a jurisdiction with a stable offset walk.
offset = 0
while True:
    page = client.get("/records", params={
        "state": "WA",
        "work_class": "solar",
        "limit": 200,
        "offset": offset,
    }).raise_for_status().json()

    for record in page["data"]:
        handle(record)

    if not page["meta"]["has_more"]:
        break
    offset += 200

# Each hit ships the exact text we embedded, so your RAG store
# can use it verbatim — you never pay to embed our corpus.
from langchain_core.documents import Document

hits = client.post("/records/search", json={
    "query": "commercial reroofing over $100k",
    "state": "TX",
    "include_chunk_text": True,
    "limit": 50,
}).json()["data"]

docs = [
    Document(
        page_content=hit["chunk_text"],
        metadata={
            "permit_number": hit["permit_number"],
            "jurisdiction": hit["jurisdiction"],
            "issued_date": hit["issued_date"],
            "source_url": hit["source_url"],
        },
    )
    for hit in hits
]