# US Building Permits API

Permit history for US properties and contractors.

| Field | Value |
| --- | --- |
| Provider | APIStead Labs |
| Category | Public Records |
| Networks | Base |
| Price | $0.01 per call |
| Base URL | https://apistead.qd.je/api/v1 |
| Verification | verified (1/1 routes) |
| Last verified | 2026-11-13T13:52:07.908Z |
| Receipt | https://basescan.org/tx/0x87fa207fe48e9a46f86e723adfa2a145d500c6e18274ebb7ff833f22e905211e |
| JSON | https://x402.apistead.qd.je/api/apis/us-building-permits-api |
| Markdown | https://x402.apistead.qd.je/api/apis/us-building-permits-api/md |
| MCP | https://apistead.qd.je/mcp |
| API reference | https://x402.apistead.qd.je/api |
| OpenAPI | https://x402.apistead.qd.je/openapi.json |

## For AI agents

Look up sample US building permit records by city and optional search text.

## Scope

Sample cities only. Not a complete national permit feed, legal verification or construction approval.

## Agent intents

- look up building permits
- check permit activity for an address
- find construction permits in a city
- research a property permit history

Permit data is useful for property due diligence, contractor lead generation, insurance underwriting and solar/roofing qualification. This API normalizes a messy local-government dataset into a consistent permit event.

The preview returns a clearly labelled sample for a small set of cities. Production connects to local open-data feeds and normalizes them behind the same shape. Each record includes a source URL and a `retrieved_at` timestamp.

## Endpoints

### GET /permits?city={city}&query={query}

Search permit events for a city.

- URL: https://apistead.qd.je/api/v1/permits?city={city}&query={query}
- Price: $0.01 USDC per call
- Pay to: 0x2E9804240E493DD8daeBa4F341a5086b92cde235
- Verified: yes
- Last checked: 2026-11-14T03:35:09.578Z
- Latency: 4 ms
- Uptime (30d): 84.85%

Example request:

```http
GET https://apistead.qd.je/api/v1/permits?city=austin&query=roof
```

Example response:

```json
{
  "city": "austin",
  "note": "Preview sample. Production connects to local open-data feeds.",
  "results": [
    {
      "type": "Residential Roofing",
      "status": "issued",
      "address": "1200 Example Ave",
      "issued_at": "2026-09-14",
      "permit_number": "2026-123456"
    }
  ]
}
```

## Payment

Every paid route uses x402 over HTTP. Call the route without payment to receive a 402 challenge, then pay the quoted USDC amount and retry. The 402 challenge is the authoritative source for price, asset, network and pay-to address. Reading this record and the discovery API is free.

- Protocol: x402 v2
- Asset: USDC
- Networks: Base
- Price: $0.01 per call

## Verification

- State: verified
- Routes verified: 1/1
- Last verified: 2026-11-13T13:52:07.908Z
- Receipt: https://basescan.org/tx/0x87fa207fe48e9a46f86e723adfa2a145d500c6e18274ebb7ff833f22e905211e

## Agent links

- JSON: https://x402.apistead.qd.je/api/apis/us-building-permits-api
- Markdown: https://x402.apistead.qd.je/api/apis/us-building-permits-api/md
- Routes: https://x402.apistead.qd.je/agent/routes?id=us-building-permits-api
- Receipts: https://x402.apistead.qd.je/agent/receipts?id=us-building-permits-api
- API reference: https://x402.apistead.qd.je/api
- MCP guide: https://x402.apistead.qd.je/mcp-docs
- Agent skill: https://x402.apistead.qd.je/skill
- OpenAPI: https://x402.apistead.qd.je/openapi.json
- MCP: https://apistead.qd.je/mcp
- Docs: https://apistead.qd.je/api


## Changelog

### 1.0.0 - Initial verified release

The route is live and settlement-verified on Base mainnet. Health checks, public receipts and agent-readable records are available.

release · 2026-11-11 · APIStead Labs