Error Codes
List of all error codes
Last updated
List of all error codes
Last updated
Below you will find the error codes for the SMS API:
1
API key is required
2
The field phoneNumbers is required
4
Message not found
10
Incorrect API key
11
Insufficient credit
13
No default price was found for the following numbers
14
The number is in the STOP SMS list
15
The number is already in the list
20
Account deactivated
22
SMS Marketing: Sending time is invalid, it must be between 8 AM and 10 PM
23
SMS Marketing: The date […] is invalid, sending SMS is not allowed on Sundays and public holidays
30
Account blocked
40
API access is denied
42
The number of characters for a Low Cost SMS is 160 characters
43
Message is required
44
Sender is invalid
45
Date is required
46
Time is required
47
Minute value is invalid
48
Minutes must be between 5 and 55 in 5-minute intervals
49
Date is invalid
50
The maximum allowed number of recipients is 500
51
The low-cost range is not eligible
52
The number of concatenated SMS cannot exceed 10
55
No number to send to
90
Malformed JSON: syntax error
96
IP address is not authorized
500
Error adding the SMS to the sending queue
992
Sender not authorized
2
The field phoneNumber is required
3
The field MessageId is required
4
This message was not found
5
The list of numbers is empty
6
The format is incorrect
9
Does not appear to be a mobile number
50
The maximum allowed number of recipients is 500
96
IP address is not authorized
2
The phoneNumber
field is required
3
The MessageId
field is required
4
This message cannot be found
5
The list of numbers is empty
6
The format is incorrect
9
Does not appear to be a mobile number
50
The maximum allowed number of recipients is 500
96
The IP address is not authorized
delivered
The SMS was successfully delivered
not delivered
The SMS was not delivered
waiting
The SMS was sent and is pending at the operator
ko
The SMS was not sent due to an error, please contact customer support
DELIVRD
The message was successfully processed and delivered.
PENDING
The message was processed and forwarded to the next instance. The delivery report has not yet been received and is still pending.
UNDELIV
The message was sent to the operator but could not be delivered because a delivery receipt with status "UNDELIV
" was canceled by the operator.
ACCEPTD
The SMS was accepted and will be sent.
UNKNOWN
An unknown error occurred.
ENROUTE
The message is on its way.
EXPIRED
The message was sent but expired due to exceeding its validity period (default is 48 hours), or the operator returned EXPIRED
as the final status.
REJECTD
The message was sent but rejected by the operator, which returned REJECTD
as the final status.
2
The phoneNumber field is required
11
Insufficient credit
13
No default price found for this destination
14
The number is in the STOP SMS list
19
Numbers must be separated by a comma
50
The maximum number of allowed recipients is 500
55
No number to send
96
The IP is not authorized
3
The parameters field is required
4
The op parameter is required
5
The urlNotification parameter is not a valid URL
6
This operation is not allowed
7
The sexe parameter is required
8
The sexe parameter must be only m, h or f
9
The minAge parameter is required
11
Insufficient credit
12
The minAge parameter must be greater than 17
13
The maxAge parameter is required
14
The maxAge parameter must be less than 99
15
The interest parameter must be greater than 0
16
The interest parameter cannot be empty
17
The subInterest parameter must not be empty
18
The subInterest parameter must be greater than 0
19
The interest or subInterest parameters are required
22
The category parameter must not be empty
23
The category parameter must be greater than 0
24
The Type parameter is required
25
The Localite parameter is required
26
The Volume parameter is required
27
The desired volume cannot be greater than the available volume
28
The DesiredVolume parameter cannot be greater than the total volume
31
The token parameter is required
32
The location request was not found
33
The location file was not found
34
The location file has already been used
35
The location file is currently being downloaded
36
The location of the file failed
61
The request seems invalid and returned no result
96
The IP is not authorized
2
You are not authorized to create subaccounts
3
The Credit field is required
4
The tokenSubaccount field is required
5
The credit must be greater than 0
6
The subaccount was not found
7
Insufficient credit for the subaccount
11
Insufficient credit
96
The IP is not authorized
Status codes: PENDING (statusGrpId: 1)
The message has been processed and sent to the mobile operator.
3
PENDING_WAITING_DELIVERY
The message has been processed and sent. The delivery report has not yet been received and is expected, so the status remains pending.
7
PENDING_ENROUTE
The message has been processed and sent to the mobile operator.
26
PENDING_ACCEPTED
The message has been accepted and processed, and is ready to be sent to the operator.
The message was not delivered.
4
UNDELIVERABLE_REJECTED_OPERATOR
A message was sent to the operator, and a delivery report with status “REJECTED” was returned.
9
UNDELIVERABLE_NOT_DELIVERED
The message was sent to the operator but could not be delivered. A delivery report with status “UNDELIVERED” was returned by the operator.
The message has been processed and successfully delivered.
2
DELIVERED_TO_OPERATOR
The message was sent and successfully delivered to the operator.
5
DELIVERED_TO_HANDSET
The message was processed and successfully delivered to the recipient.
The message was sent but expired either because it was pending beyond its validity period (our platform is configured by default for 48 hours), or because the delivery report from the operator returned “EXPIRED
” as the final status.
15
EXPIRED_EXPIRED
The message was received and sent to the operator. However, it remained pending until it expired or until the operator returned the EXPIRED status.
29
EXPIRED_DLR_UNKNOWN
The message was received and sent to the operator for delivery. However, the operator's delivery report was not properly formatted or was not recognized as valid.
The message was received but was rejected by the operator.
6
REJECTED_NETWORK
The message was received, but the network is outside our coverage.
8
REJECTED_PREFIX_MISSING
The message was received but was rejected because the number is unrecognized due to a missing or incorrect prefix/number length. These details vary by network and are updated regularly.
10
REJECTED_DND
The message was received and rejected because the user is subscribed to DND (Do Not Disturb) services, which block service traffic to their number.
11
REJECTED_SOURCE
Your account is set to only accept registered sender IDs, but the sender ID in the request is not registered on your account.
21
REJECTED_SYSTEM_ERROR
The request was rejected due to a system error. Please retry submission or contact our technical support team for more details.
52
REJECTED_DESTINATION
The request was received, but the destination is invalid – the number prefix is incorrect as it does not match any valid mobile operator prefix. The number length is also considered to verify its validity.
OK (errorGrpId: 0)
The request was successfully processed.
0
false
NO_ERROR
No error description provided. Usually returned for successful delivery or when no error code was returned by the operator.
The request could not be completed due to issues related to the mobile handset.
1
true
EC_UNKNOWN_SUBSCRIBER
The number does not exist or hasn't been assigned to an active subscriber in the operator's database.
5
false
EC_UNIDENTIFIED_SUBSCRIBER
Unidentified subscriber
6
false
EC_ABSENT_SUBSCRIBER_SM
The subscriber is detected as unavailable, often because the device is off or in a low-signal area. Applies to MAP protocol version 3.
7
false
EC_UNKNOWN_EQUIPMENT
The handset was not recognized by the EIR (Equipment Identity Register) during MAP-level equipment verification on the operator’s infrastructure.
8
false
EC_ROAMING_NOT_ALLOWED
The subscriber is roaming and roaming service is not guaranteed due to lack of agreements between operators.
9
true
EC_ILLEGAL_SUBSCRIBER
Illegal subscriber
11
true
EC_TELESERVICE_NOT_PROVISIONED
The subscriber’s mobile service was suspended by the operator.
12
true
EC_ILLEGAL_EQUIPMENT
Illegal equipment
13
false
EC_CALL_BARRED
The message was rejected due to SMS service being barred, either by the operator or subscriber.
27
false
EC_ABSENT_SUBSCRIBER
The subscriber is offline, usually because the device is off.
31
false
EC_SUBSCRIBER_BUSY_FOR_MT_SMS
Subscriber busy for MT SMS
32
false
EC_SM_DELIVERY_FAILURE
Delivery failure
33
false
EC_MESSAGE_WAITING_LIST_FULL
Message waiting list full
34
false
EC_SYSTEM_FAILURE
System failure
35
false
EC_DATA_MISSING
Missing data
36
false
EC_UNEXPECTED_DATA_VALUE
Unexpected data value
255
false
EC_UNKNOWN_ERROR
Unknown error
256-1031
false
[Multiple Errors]
Various network-level or equipment-related issues (e.g., memory exceeded, congestion, misformatted data, unreachable subscribers, protocol mismatches).
A user-related error occurred.
2049
true
EC_IMSI_BLACKLISTED
IMSI blacklisted
2052
true
EC_BLACKLISTED_DESTINATIONADDRESS
Destination number blacklisted (either by operator or on your account via SMSPartner portal)
2053
true
EC_BLACKLISTED_SENDERADDRESS
Sender number blacklisted (either by operator or on your account via SMSPartner portal)
2053
true
EC_SOURCE_ADDRESS_BLACKLISTED
Source address is blacklisted in your SMSPartner account
4096–4104
true
[Various User Errors]
Issues like invalid PDU format, message canceled, expired validity, SMPP connectivity missing, or flooding detected due to message repetition.
The request could not be completed due to operator-side issues.
10
true
EC_BEARER_SERVICE_NOT_PROVISIONED
Bearer service not provisioned
20
false
EC_SS_INCOMPATIBILITY
SS incompatibility
51
true
EC_RESOURCE_LIMITATION
Operation failed due to SS7 network congestion
71
false
EC_UNKNOWN_ALPHABET
Unknown alphabet
501
false
EC_INVALID_RESPONSE_RECEIVED
Invalid response received
2048
false
EC_TIME_OUT
Timeout occurred
2050
true
EC_DEST_ADDRESS_BLACKLISTED
Number is blacklisted by the operator (e.g., DND list)
PHONE_NUMBER_REQUIRED
The phone number is required
PHONE_NUMBER_SIZE_ERROR
The number of recipients exceeds 500
TOKEN_AUDIO_REQUIRED
The audio token is required
NOTIFY_URL_INVALID
The notification URL is invalid
SENDER_NOT_AUTHORIZED
The sender is not authorized
SENDER_INVALID
The sender is invalid
AUDIO_FILE_NOT_FOUND
The audio file could not be found
DESTINATION_INVALID
The phone number is not allowed
NOT_CREDIT
Insufficient credit
1
API key is required
2
Email content is required
3
API key is required
4
Sender email is required
5
Sender name cannot be empty
8
Attachment URL is required
9
Attachment extension is not allowed
10
Invalid API key
11
Insufficient credit
14
Email is on the unsubscribe list
15
Email is already in the sending list
16
Attachment name cannot be empty
17
Maximum number of recipients exceeded
18
Recipient's email is required
19
Recipient's email appears invalid
20
Account is deactivated
21
Recipient's name cannot be empty
22
Recipient list is required
23
Reply-to email is required
24
Reply-to email appears invalid
25
Reply-to name cannot be empty
30
Account is blocked
40
API access is denied
45
Date is required
46
Time is required
47
Minutes value is invalid
48
Minutes must be between 5 and 55 in a 5-minute interval
49
Date is invalid
50
Maximum number of allowed emails is 500
55
No default price found
90
Malformed JSON: syntax error
96
IP is not authorized
429
Too many requests in one minute (limit: 2000 requests/minute/IP)
500
Issue occurred while adding the email to the sending queue