Skip to content
Cascade Cascade
Қазақша Русский English

API

API errors

Check the HTTP status and the success field in JSON.

Quick Answer

Handle success=false and message texts; do not rely on the HTTP code alone.

Summary

401 — authorization, 422 — business/validation, 429 — too many attempts. Always read message.

Key Takeaways

  • 401 = Bearer token problem.
  • 422 = phone, balance, channel, cooldown.
  • 429 is possible on verify.

Related Questions

Contents

  1. Table
  2. Example messages

Table

HTTP Meaning
200 + success: true Success
200/422 + success: false Business error
401 Missing / invalid token
422 Validation or business rule
429 Too many attempts (verify)

Example messages

  • “Invalid phone number format”
  • “Insufficient broadcast tokens. Top up your balance.”
  • “Please wait before resending OTP”
  • “WhatsApp is not connected. Contact the administrator.”
  • “Invalid or expired code”

See rate-limits, top-up, FAQ, documentation.

Documentation API Pricing FAQ