API Documentation

Read-only JSON access to aggregated Seattle construction permit and contractor data. No authentication required. Base URL https://buildingseattle.com.

GET /api/permits

Query permits with optional filters and pagination. Returns { total, page, per_page, results[] }.

ParameterDescription
neighborhoodFilter by neighborhood.
typeFilter by permit type.
statusFilter by permit status.
qFree-text search across address, description, permit number, neighborhood, and contractor name.
pagePage number (default 1).
per_pageResults per page (1-100, default 50).

GET /api/contractors

List the top 20 contractors ranked by active project count. Each record includes an active_projects count.

GET /api/stats

Aggregate counts and permit value totals for the dashboard.

Machine-readable: OpenAPI spec · API catalog