Error codes

API errors are structured to help the developer fix the request or configuration quickly.

Examples

  • VALIDATION_ERROR: the payload is incomplete or invalid.
  • AUTHENTICATION_ERROR: the key or token is not correct.
  • RATE_LIMITED: too many requests were sent during a given period.
  • NOT_FOUND: the requested transaction does not exist or is no longer accessible.

When to handle them

  • Display a clear message to the user for validation errors.
  • Log technical errors on the server side so support and debugging have a useful history.