Skip to main content

Errors​

The Zip API uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, an action failed, etc). Codes in the 5xx range indicate an error with our servers (these are rare).

Some common error responses are listed below:

  • 400 Bad Request — Your request may be malformed
  • 401 Unauthorized — Your API key is wrong, or your account does not have access to this resource
  • 403 Forbidden — The record requested is hidden
  • 404 Not Found — The specified record could not be found
  • 405 Method Not Allowed — You tried to access a resource with an invalid method
  • 422 Unprocessable Entity — Your request is invalid
  • 429 Too Many Requests — You have exceeded the API rate limit