Building permits

List building permits

Changed on

Building permits issued by cities, from each city's open-data portal. Each item's date is the day the permit was issued. Sort with sort; page by passing next_cursor back as cursor. as_of is when the data was last known current. Records dated in the last 14 days for every key; API Pro reaches every record.

get/api/permits

Request

Query parameters

citystring

A city's slug, such as seattle. GET /api/datasets lists the cities.

qstring

Words in the permit type, description or contractor.

kind'commercial' | 'residential' | 'other'

What the building is used for, as the city records it; other when the city does not say.

min_valuenumber

Least declared project value, in dollars.

zipstring

Five-digit ZIP code.

afterstring date

Only records dated on or after this day (YYYY-MM-DD). Within the last 14 days for every key; earlier needs API Pro (403 otherwise).

sort'newest' | 'largest'

newest: by date, newest first; largest: by amount, largest first, records without one left out.

cursorstring

next_cursor from the previous page, unchanged, with the same sort.

limitinteger

Items to return; clamped to 1–100.

Response

OK

as_ofstring date-time nullable required

When this dataset was last known current: the oldest last successful read among its sources (the city's own, with city).

countinteger required
next_cursorstring nullable required

Pass as cursor for the next page; null at the end.

Changes