Error Codes

When an error occurs, the API returns a structured error response:

{
  "success": false,
  "error": {
    "code": "E1001",
    "message": "Invalid or malformed token",
    "requestId": "req_abc123xyz"
  }
}

Error Code Reference

Code	HTTP	Description
E1001	401	Invalid or malformed token
E1003	403	Insufficient permissions
E1004	429	Rate limit exceeded
E1005	401	Authentication token required
E2001	400	Invalid request format
E2002	400	Required field is missing
E4001	422	Insufficient SMS credit
E4002	400	Invalid recipient number
E4003	400	Message too long
E7001	404	Contact not found
E7006	409	Duplicate mobile number
E8001	404	Ticket not found
E8002	423	Ticket is closed
E9001	500	Internal server error