This tutorial will show you how to use the Shovels API to retrieve permit history for an address.
GET /v2/addresses/search
endpoint, and enter the address string.In this example, we’ll use cURL to make the request, and look for the address “123 Main St”.geo_id
of the address. It should look like a alphanumeric string.geo_id
is the unique identifier for all location objects in the Shovels platform. These don’t only correspond to individual addresses or property plots, but also exist for other geographical segments like cities
, counties
, jurisdictions
, and states
.geo_id
will be what you need for Step 3.GET /v2/permits/search
endpoint, and enter the geo_id
you extracted in Step 2.You will also need to specify the permit_from
and permit_to
strings, which are required fields. These represent the time bounds to search for permits for the given address.