GET

/permits

Returns a list of building and construction permits for a jurisdiction.

Base URL

https://api.threshmoor.com

Query parameters

Parameter	Type	Default	Required	Description
`limit`	integer	25	No	How many permits to return. Accepted range: 1–100.
`permit_type`	string	—	No	Keyword filter by permit type (e.g. "Electrical", "Building"). Case-insensitive.

Response shape

Every successful response is wrapped in a PermitResponse object:

{
  "jurisdiction": string,
  "count":        number,
  "permits":      Permit[]
}

Permit object

Field	Type	Description
`permit_number`	string \| null	The jurisdiction-assigned permit number.
`permit_type`	string \| null	Category of the permit (e.g. "Building Permit", "Electrical Permit", "Plumbing Permit").
`work_class`	string \| null	Classification of the work (e.g. "New", "Remodel", "Demolition").
`status`	string \| null	Current status of the permit (e.g. "Active", "Final").
`description`	string \| null	Free-text description of the permitted work.
`issued_date`	string \| null	Date the permit was issued (ISO 8601 format).
`applied_date`	string \| null	Date the permit application was submitted (ISO 8601 format).
`address`	string \| null	Street address of the permitted work.
`city`	string \| null	City name.
`zip`	string \| null	ZIP / postal code.
`valuation`	string \| null	Estimated dollar value of the work.
`contractor`	string \| null	Name of the contractor on record.
`latitude`	string \| null	Latitude coordinate of the permit location.
`longitude`	string \| null	Longitude coordinate of the permit location.
`jurisdiction`	string	The jurisdiction this record belongs to (always present, e.g. "Austin, TX").

Example

Request

GET /permits?limit=2&permit_type=Building HTTP/1.1
Host: api.threshmoor.com
X-API-Key: thresh_live_...

Response — 200 OK

{
  "jurisdiction": "Austin, TX",
  "count": 2,
  "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 for Building 13",
      "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"
    }
  ]
}

Error responses

Status	Meaning
`502`	The upstream data source is unreachable or returned an unexpected response. The API never leaks raw errors — you will receive a short, human-readable message.

{
  "detail": "Could not reach the Austin permit data source: ..."
}