Errors

All errors use the same envelope. Stack traces are never returned to clients.

error envelope
{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet available balance is too low to reserve this send.",
    "request_id": "req_01hx..."
  }
}
  • INVALID_PHONE_NUMBER
  • INVALID_SENDER_ID / SENDER_NOT_APPROVED
  • INSUFFICIENT_BALANCE
  • RATE_LIMITED
  • INVALID_API_KEY
  • IDEMPOTENCY_CONFLICT
  • TEST_KEY_LIVE_FORBIDDEN
  • UNAUTHENTICATED
  • MFA_REQUIRED / STEP_UP_REQUIRED