Skip to content
Contact us
  • There are no suggestions because the search field is empty.

How to Search for Permits by Address Using API Endpoints

This article explains how to search for permits associated with a specific address using the available API endpoints.

To retrieve the permit history for a specific address, follow this two-step process:

Step 1: Get the Address's Geo ID

Use the Search Addresses endpoint with your target address. This returns the address's geo_id—a unique identifier you'll need for the next step.

Step 2: Search Permits Using the Geo ID

Use the Search Permits endpoint with the geo_id from Step 1, along with your desired date range.

Pro tip: The geo_id parameter is a unified geography filter. The same permit search works whether you pass in a state abbreviation (CA), a zip code (94103), or an individual address's geo_id. You're just swapping out the geography level.

Alternative: Use Shovels Online

For quick lookups without code, use the Location Search feature in Shovels Online to search by address directly.

Need Help?