Skip to main content
GET
Get a standardized list of building permits aggregated from municipalities, filterable by municipality, text search, permit metadata, and update window.

Query Parameters

integer
default:"100"
Maximum number of permits to return per request. Default: 100. Upper bound depends on your plan tier. Example: 25.
integer
default:"0"
Number of records to skip for pagination. Example: 50.
string
Filter permits by issuing municipality slug. Comma-separated values are accepted. Example: toronto, calgary.
string
Partial match across the permit search surface, including address, neighbourhood, work description, raw and canonical permit type, building type, and applicant or contractor names where available. Example: 123 King St.
string
One of new_construction, renovation, addition, demolition, change_of_use, or other. Example: new_construction.
string
Partial match on the municipality’s raw permit type or class text. Example: New Building.
string
One of issued, in_review, completed, cancelled, or expired. Example: issued.
string
Partial match on the normalized building or property type text. Example: residential.
string
Partial match on neighbourhood, ward, or district text where available. Example: Annex.
string
Partial match on applicant_name. Example: Smith Construction.
string
Partial match on contractor_name. Example: Smith Construction.
string
ISO 8601 start date. Example: 2023-01-01.
string
ISO 8601 end date. Example: 2023-12-31.
string
ISO 8601 start date for the record’s last_updated timestamp. Example: 2024-01-01.
string
ISO 8601 end date for the record’s last_updated timestamp. Example: 2024-12-31.
string
default:"date"
One of date, issued_date, application_date, updated, last_updated, published, value, or distance. distance requires lat, lng, and radius_km. Example: date.
For polling or incremental syncs, use sort_by=last_updated&sort_order=desc with updated_after set to your last successful sync timestamp.
string
default:"desc"
Either asc or desc. Example: desc.
number
Latitude for proximity search. Must be provided with lng and radius_km. Example: 43.6532.
number
Longitude for proximity search. Must be provided with lat and radius_km. Example: -79.3832.
number
Radius in kilometres for proximity search. Must be between 0.1 and 100. Example: 5.

Proximity search example

Find all permits within 2km of a coordinate:

Proximity search example

Find all permits within 2km of a coordinate:

Proximity search example

Find all permits within 2km of a coordinate: