Skip to main content
A 422 error in the Shovels API means a required parameter is missing from your request. The most common cause is querying permits without first resolving your address to a geo_id. Solution: Use the Address Search endpoint to get a geo_id, then use that geo_id in your permit query.

​
Common Causes

​
Missing geo_id

If you query permits without including a geo_id:

​
Invalid geo_id Format

If the geo_id format is incorrect or wasn’t obtained through address resolution.

​
How to Fix

  1. Resolve the address first - Use the Address Search API to get a valid geo_id
  2. Check required parameters - Review the API documentation for required fields
  3. Review the error message - The JSON output helps identify what’s missing

​
Example Workflow

Always check the error response body—it tells you exactly what’s missing or invalid.

​
Full Documentation

For complete 422 error details including all location types and error examples, see API Introduction - 422 Unprocessable Entity.