Resources

API Status Codes - HTTP Error Handling Reference

Complete reference of Statum API HTTP status codes. Troubleshoot 400, 401, 403, 500 errors and learn how to handle API responses in your M-Pesa, Airtime, and SMS integrations.

Mastering API status codes is essential for building resilient applications. Statum APIs leverage standard HTTP response codes (RFC 2616) to communicate the outcome of every transaction. This guide provides a detailed breakdown of success, client-side errors, and server-side issues to help you troubleshoot and optimize your integration.

HTTP Status Code Reference

Understanding these codes helps you debug integrations faster. We recommend logging the status_code from every API response for audit trails.

Status Code Meaning & Context Recommended Action
200 OK Request Successful Proceed with processing the response payload.
401 Authentication Failed Verify your Base64 encoded credentials in the header.
402 Insufficient Funds Top up your wallet balance on the developer dashboard.
422 Validation Error Check required fields (e.g., phone number format).
429 Too Many Requests Ease off your request rate and implement backoff.
500 Server Error Possible gateway issue. Retry after 5-10 seconds.