Documentation menu

Quickstart

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

1. Make a request

Every data endpoint follows the same pattern:

GET /{vertical}?jurisdiction={city}&limit={n}

For example, fetch five building permits from Austin, TX:

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

Available endpoints

The same pattern works across all five data verticals:

EndpointDataFilter param
/permitsBuilding & construction permitspermit_type
/violationsCode enforcement violationsviolation_type
/landuseLand development & zoning applicationscase_type
/businessesBusiness licenses & registrationsbusiness_type
/propertyProperty transfers & assessmentsproperty_type

Every endpoint also accepts jurisdiction and limit (1–100, default 25).

2. Read the response

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

Example response from /permits (truncated to two records):

{
  "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 query parameters, response schemas, and error codes for each endpoint in the API Reference: