Skip to main content

Error Codes Reference

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