Geocodio 422 Unprocessable Entity Error

How to troubleshoot a 422 Unprocessable Entity Error when it is returned by the Geocodio API

422 errors typically occur when the input we have received is not able to be processed successfully. For example, if an invalid or incomplete address has been provided. The error message you receive should provide some detail regarding what may be missing.

Troubleshooting Options

  1. If your input is an address, ensure that either a City/State combination - or - a Zip Code has been supplied with the input

In order to determine the location of an address, Geocodio requires either a combination of city and state or a Zip Code. We are not able to process a response without this information.

For example, this address would not be able to read by our geocoder:

  • "123 Main St"

Whereas these addresses would be considered complete and would be much more likely to receive a response:

  • "123 Main St, New York, NY"
  • "123 Main St 11367"
  • "123 Main St New York, NY 11367"

There are extremely rare instances where even this type of formatting might return no response. In these edge cases, try providing a complete address that includes City, State and Zip Code. In general, the more information you can provide Geocodio, the more likely will we be to be able to complete your request.

  1. If your input is an address, verify that the address in question exists

There are occasions when an address is so new that it does not yet exist in our system - or - an older address has been changed or demolished. If possible, double check to make sure that the address you are inputting is accurate and does exist. If so, proceed to the our fourth troubleshooting option.

  1. If your input is a coordinate pair, verify that the formatting of the coordinates is accurate

When reverse geocoding, be certain that the following is true for any coordinates you submit:

  • Both latitude and longitude are supplied in the input
  • Verify that the coordinates are ordered correctly. Latitude should be listed first, followed by longitude.
  • Be sure that any necessary punctuation is included with the coordinates. For example, many lat/longs requires a dash ("-") before the numeric values.
  1. Report an address or coordinate pair that returns no response

If you are certain that the address you're submitting exists, feel free to submit an address error report through your account dashboard. We will investigate the address, do our best to identify its location, and wherever possible manually add the address to our database.

Upload a spreadsheet now. No credit card required.

Upload SpreadsheetGet an API Key
Copyright © 2014-2025 Dotsquare LLC, Norfolk, Virginia. All rights reserved.