Sample Response Codes

Note: This list is a work in progress and may be updated as needed as some fixes are being done.

Response Codes Reference

Code Description
200 Successful Request Call
1001 Invalid sender id
1002 Network not allowed
1003 Invalid mobile number
1004 Low bulk credits
1005 Failed. System error
1006 Invalid credentials
1007 Failed. System error
1008 No Delivery Report
1009 Unsupported data type
1010 Unsupported request type
1012 Too Many messages on SMS LIST
1104 Too many comma separated contacts
4090 Internal Error. Try again after 5 minutes
4091 No Partner ID is Set
4092 No API KEY Provided
4093 Details Not Found

Success Codes

200: Successful Request Call

Your request was successful and has been processed. The API response will include relevant data based on your request.

Error Codes (1000-1100 Series)

1001: Invalid Sender ID

The shortcode/sender ID you provided is invalid or not assigned to your account. Verify your shortcode in the account settings.

1002: Network Not Allowed

The recipient's network is not supported on your account. Contact support to enable additional networks.

1003: Invalid Mobile Number

The mobile number format is incorrect. Use the correct format for the region (e.g., 254xxxxxxxx).

1004: Low Bulk Credits

Your account doesn't have sufficient credits. Purchase more credits to proceed.

1005: Failed - System Error

An internal system error occurred. Retry your request after a few moments.

1006: Invalid Credentials

Your API key or Partner ID is invalid. Regenerate credentials from your account.

1007: Failed - System Error

An internal system error occurred. Retry your request after a few moments.

1008: No Delivery Report

The delivery report is not yet available. Wait a moment and try again.

1009: Unsupported Data Type

The data type provided is not supported. Ensure parameters are of the correct type.

1010: Unsupported Request Type

The request method is not supported. Use GET or POST as documented.

1012: Too Many Messages on SMS LIST

Your bulk request exceeds 1000 messages. Split into multiple requests.

1104: Too Many Comma-Separated Contacts

The number of contacts exceeds the limit. Use the Bulk SMS endpoint for multiple recipients.

Error Codes (4000 Series)

4090: Internal Error - Try Again After 5 Minutes

A temporary internal error occurred. Wait 5 minutes before retrying.

4091: No Partner ID is Set

The Partner ID parameter is missing. Include it in your request.

4092: No API KEY Provided

The API key parameter is missing. Include it in your request.

4093: Details Not Found

The requested resource was not found. Verify the identifiers are correct.

Last Updated: 2/24/2025 | Contributors: Macrologic API Team