Errors

In the event of a client or server error, the response will contain a 4xx or 5xx status code, respectively, accompanied by a well-formed JSON body describing the issue, e.g., a required field was omitted.

Each client library will encapsulate these errors and raise an exception, in addition to other exceptional cases, such as network failures. It is recommended to handle exceptions gracefully and to report any issues to support@easypost.com.

{
  "code": "ADDRESS.VERIFY.FAILURE",
  "message": "Address not found",
  "errors": [
    {
      "field": "address",
      "message": "Address not found",
      "suggestion": null
    },
    {
      "field": "street1",
      "message": "House number is missing",
      "suggestion": null
    }
  ]
}

{
  "field": "address",
  "message": "Address not found",
  "suggestion": null
}