Skip to main content

Error Codes Reference

Looking for SMPP protocol-level and MO (Mobile-Originated) delivery error codes instead? See the Standard SMPP Error Code List.
The Ruach SMS API returns standardized error codes to help you understand and handle different response scenarios.

Success Codes

Authentication & Account Errors

Message & Content Errors

Group & Template Errors

System & Processing Errors

Data & Validation Errors

Gateway & Routing Errors

Error Response Format

All error responses follow this standard format:

Handling Errors

Common Error Handling Patterns

Best Practices

  1. Always check ErrorCode: Never assume success without checking the error code
  2. Handle common errors: Implement specific handling for frequent errors (001, 021, 015)
  3. Log errors: Keep logs of error responses for debugging
  4. Retry logic: Implement retry logic for transient errors (033, 034)
  5. User feedback: Provide meaningful error messages to end users