Searching for Permits
Using geo_id to retrieve permit data effectively
To search for permits in the Shovels API, you'll need to use the geo_id parameter, which serves as the unique identifier linking addresses to their associated permit data. The process follows these steps: First, use our Address Search endpoint (https://api.shovels.ai/v2/addresses/search) to find the address of interest. When the address is found, you'll receive a geo_id in the response. Then, use this geo_id to query our permits search endpoint, which will return all permits associated with that location. The geo_id system offers several advantages over direct address searching: it ensures consistent identification regardless of address formatting variations, provides a stable reference point even if address details change over time, and improves query performance. Our permit search endpoint supports additional filters including date ranges, permit types, and contractor information, allowing you to narrow results to precisely the permits you need. This two-step process of address resolution followed by permit querying ensures accurate results and optimal API performance.