Licence
Apache-2.0
Version
1.0.5
Deps
0
Size
67 kB
Vulns
0
Weekly
0
permitstack-sdk
Official TypeScript / JavaScript SDK for the PermitStack building‑permit API — 77M+ U.S. building permits across 8,000+ cities in all 50 states, updated daily from official open‑data portals (Socrata, ArcGIS, Tyler EnerGov, Accela, and more).
Install
npm install permitstack-sdk
Quick start
import { Permitstack } from 'permitstack-sdk';
// Get a free API key (100 requests/day) at https://permit-stack.com/#pricing
const client = new Permitstack({ apiKey: 'pk_your_key' });
// Search permits
const results = await client.permits.searchPermits({
city: 'Austin',
category: 'SOLAR',
issuedAfter: '2026-01-01',
});
console.log(`${results.total} matches`, results.results);
Your key is sent automatically as the X-API-Key header on every request.
Resources
| Namespace | What it does |
|---|---|
client.permits |
Search & export permits, permit detail, status/transition events, address & parcel lookup |
client.contractors |
Contractor search & profiles |
client.propertyHistory |
Per‑address permit history |
client.webhooks |
Register filter‑scoped webhooks (available from the Developer tier) |
client.health |
Service health & coverage stats |
All list endpoints return a total (a floor — total_capped: true — once a result set exceeds 10,000; narrow your filters for an exact count).
Links
- API docs & pricing: https://permit-stack.com
- OpenAPI spec: https://api.permit-stack.com/public-openapi.json
- Python SDK:
permitstack· MCP server:permitstack-mcp
License
Apache-2.0