Documentation menu

Quickstart

Get your first permit response in under a minute. All you need is curl (or any HTTP client).

1. Make a request

Fetch five permits from Austin, TX:

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.threshmoor.com/permits?limit=5"

2. Read the response

The API returns a JSON object containing the jurisdiction name, a count, and an array of permit records. Every permit follows the same schema regardless of source.

Example response (truncated to two records for brevity):

{
  "jurisdiction": "Austin, TX",
  "count": 5,
  "permits": [
    {
      "permit_number": "2026-076303 BP",
      "permit_type": "Building Permit",
      "work_class": "Demolition",
      "status": "Active",
      "description": "Total demo of sfr 1299 sqft",
      "issued_date": "2026-06-16T00:00:00.000",
      "applied_date": "2026-06-04T00:00:00.000",
      "address": "2817 E 22ND ST",
      "city": "AUSTIN",
      "zip": "78722",
      "valuation": "0",
      "contractor": "Joseph Design Build",
      "latitude": "30.28405859",
      "longitude": "-97.71079459",
      "jurisdiction": "Austin, TX"
    },
    {
      "permit_number": "2026-076995 BP",
      "permit_type": "Building Permit",
      "work_class": "Remodel",
      "status": "Active",
      "description": "Re-roof: replacing asphalt shingles",
      "issued_date": "2026-06-16T00:00:00.000",
      "applied_date": "2026-06-16T00:00:00.000",
      "address": "9218 BALCONES CLUB DR BLDG 13",
      "city": "AUSTIN",
      "zip": "78750",
      "valuation": null,
      "contractor": "North Gable Contractors",
      "latitude": null,
      "longitude": null,
      "jurisdiction": "Austin, TX"
    }
  ]
}

What’s next

See the full list of query parameters, response fields, and error codes in the Permits endpoint reference →