Live data · Updated monthly

45 years of American housing. Now queryable.

The only API tracking U.S. residential building permits from 1980 to present. Clean single-family / multifamily split. Searchable to the city level. From $9/month.

45 Years of history
167k+ Records
City Granularity
$9 Entry price
South Region Annual Permits · 1980–2024
Single Family
Multifamily
Mid-80s Boom S&L Downturn 90s Expansion Housing Bubble GFC Bust Recovery COVID Boom Rate Correction
Live API Demo

A three-line query. 45 years of context.

Request
Response · 200 OK

      
Why PermitBase

Built for the analysis that other datasets can't do.

45

Deepest history in the market

Every competitor starts around 2000. PermitBase goes to 1980 — covering four full housing cycles, including the S&L boom, the dot-com era, and the 2008 crash. Context that changes analysis.

SF

Clean SF / MF differentiation

Single family, duplex, 3–4 unit, and 5+ unit permits tracked separately with unit counts, not just building counts. The data you need for supply analysis, zoning research, and market modeling.

$9

12× cheaper than the competition

Shovels.ai starts at $599/month. ATTOM and CoStar are $10,000+/year. PermitBase delivers the specific dataset researchers and developers actually need — without the enterprise price tag.

Feature PermitBase Shovels.ai ATTOM / CoStar Census BPS (free)
History back to 1980 1980–present ~2000–present ~2000–present 1980–present
REST API access Yes Yes Yes No API
SF / MF unit split Full breakdown Property-level only Yes Yes (clunky)
City / place level Yes Yes Yes Requires download
Entry price $9 / month $599 / month $10,000+ / year Free (no API)
Bulk CSV export Professional+ Limited Yes (enterprise) Manual download
AI-Native

Built for the Agent Economy

PermitBase is infrastructure for AI agents, not just human analysts. Plug into Claude, GPT, or any LangChain agent in minutes.

🔌

MCP Server

Add PermitBase to Claude Desktop or any MCP-compatible agent. Ask permit questions in plain English — no API calls to construct.

{
  "mcpServers": {
    "permitbase": {
      "command": "python",
      "args": ["mcp_server.py"],
      "env": {
        "PERMITBASE_API_KEY": "pb_live_..."
      }
    }
  }
}
🦜

LangChain Toolkit

5 typed tools, one import. Drop into any LangChain or LangGraph agent. Works with GPT-4o, Claude, Gemini, or any OpenAI-compatible model.

pip install langchain-permitbase

from langchain_permitbase import PermitBaseToolkit

tools = PermitBaseToolkit(
  api_key="pb_live_..."
).get_tools()
# 6 tools ready for any agent
💬

Natural Language API

The /ask endpoint accepts plain English. Your agent doesn't need to know the schema — just ask.

GET /v1/permits/ask?q=
  What does the supply pipeline
  look like in Phoenix relative
  to the 2005 bubble peak?

→ { data: [...], summary: "..." }

Listed on Smithery.ai · OpenAI GPT Actions · Hugging Face Datasets

Pricing

Start free. Scale when you're ready.

No credit card required for the free tier. Annual billing saves 20%. All plans include access to the full 1980–present dataset.

Free
$0
Perfect for exploring the dataset and building proofs of concept.
  • 50 API calls / month
  • All endpoints
  • Full 1980–present data
  • JSON responses
  • CSV export
  • Trends endpoint
Get Free Key
Professional
$29/mo
For PropTech products, investment firms, and lenders needing high-volume access.
  • 50,000 API calls / month
  • All endpoints
  • Full 1980–present data
  • CSV bulk export
  • Webhook notifications
  • Priority email support
Start Professional
Data Partner
$99/mo
For data platforms, aggregators, and products that embed or redistribute the data.
  • Unlimited API calls
  • Redistribution license
  • Snowflake / BigQuery share
  • Parquet file delivery
  • Dedicated support
  • SLA available
Contact Sales
Use Cases

Who builds with PermitBase.

🏗️

PropTech Developers

Embed 45 years of permit history into your housing platform. Build supply-side indicators, market cycle dashboards, or undersupply alerts. Clean JSON API — integrate in a day.

GET /v1/permits/trends?state=Texas&metric=mf&year_from=1990
🎓

Developers & Economists

Housing economists, urban planners, and PhD students use PermitBase as the data layer for peer-reviewed research. Academic pricing available. Free tier for initial exploration.

GET /v1/permits/cycles?state=Florida
🏢

Real Estate Developers & Investors

Understand supply pipelines in your target markets. See where multifamily has historically concentrated, identify undersupplied markets, and benchmark your submarkets against history.

GET /v1/permits/rankings?state=48&ranked_by=mf&year_from=2015
🏦

Lenders & Underwriters

Add historical permit context to your underwriting models. Assess market cycle position, validate developer pipeline claims, and flag supply-risk markets before committing capital.

GET /v1/permits/annual?state=Georgia&year_from=2000&year_to=2024
Quick Start

Live in three steps.

1

Get your API key

Sign up above — free tier requires no credit card. Your key is issued instantly.

X-API-Key: pb_live_your_key_here
2

Make your first request

Query annual permit trends for any state. Optionally filter to a specific county, city, or year range.

curl https://api.permitbase.org/v1/permits/annual \
-H "X-API-Key: pb_live_your_key_here" \
-G -d "state=Texas&year_from=2010&year_to=2024"
3

Parse the response

Clean JSON with typed fields. Every response includes rate limit headers so you always know where you stand.

// JavaScript
const res = await fetch('https://api.permitbase.org/v1/permits/annual?state=Texas', {
headers: { 'X-API-Key': 'pb_live_your_key' }
});
const { data } = await res.json();
console.log(data[0]); // { year: 2010, sf_units: 85421, mf_total: 34982, ... }
Get started

The historical layer your analysis is missing.

Free tier. No credit card. 500 calls/month to explore 45 years of data.

Get Your Free API Key → Talk to Sales