Errors

Generic error response (4xx, 5xx)

{
  "errors": [
    {
      "id": "not_found",
      "message": "Not found"
    }
  ]
}

Validation failed (400)

{
  "errors": [
    {
      "id": "validation_error",
      "message": "Please enter a valid email address."
    }
  ]
}

All error messages will return both machine (id) and human readable (message) error message. All errors, except validation_error, return only one error.

validation_error with status code 400 is returned when the validation of the resource fails on POST or PUT requests. Response contains errors field with a list of errors.

Important: Different error types (id) can be added and removed over time so you should make sure your application accepts new ones as well.

Error id	Code	Description
param_required	400	Missing parameter
validation_error	400	Unable to validate POST/PUT
invalid_request	400	Invalid request
authentication_error	401	Invalid auth (generic)
insufficient_funds	402	User has insufficient funds
invalid_scope	403	User hasn't authenticated necessary scope
not_found	404	Resource not found
not_acceptable	406	Missing or incompatible Accept-Encoding header.
rate_limit_exceeded	429	Rate limit exceeded
internal_server_error	500	Internal server error