Doc Partner
SMS Partner
Doc Partner - EN
Doc Partner - EN
  • Welcome
  • API
    • SMS Partner
      • Credits
      • Send SMS
        • Single Send
        • Bulk Send
        • Send by Long Number
        • Survey Send
        • Cancel Scheduled SMS
        • Special Characters
      • Status & Statistics
        • Single Status
        • Bulk Status
        • Status by Message
        • Status by Tag
        • Sending Statistics
      • Contact Management
        • Add Group
        • Add Contact
        • Delete Group
        • Add Bulk Contacts
        • Edit Contact
        • Delete Contact
        • Get Group List
        • Get Contact List
        • Get Contact Details
      • Replies / Opt-outs Management
        • Stop List
        • Add Number to SMS Stop List
        • Remove Number from SMS Stop List
        • Replies Management
      • Sub-accounts
        • Activation
        • Create Sub-account
        • Delete Sub-account
        • Sub-account List
        • Manage Sub-account Credits
      • Manage Call Forwarding
      • Number Verification
        • Send a Verification
        • Format Verification
      • Contact Rental
        • Categories
        • Targeting & Calculation
        • Rental Status
        • Download File
      • RCS
    • Error Codes
Powered by GitBook

© 2025 NDA Media

On this page
  • API Error Codes
  • SMS Sending
  • SMS Cancellation
  • Status Retrieval
  • Status List
  • Status Error Codes
  • Number Verification
  • Location
  • Subaccount
  • HLR
  • Error Codes (HLR)
  • Voice Message Sending / VMS
  • Email Sending
  1. API

Error Codes

List of all error codes

PreviousRCS

Last updated 1 month ago

API Error Codes

Below you will find the error codes for the SMS API:

SMS Sending

Codes
Message

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

SMS Cancellation

Codes
Message

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

Status Retrieval

Codes
Message

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

Status List

Codes
Message

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

Status Error Codes

SMS Status

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.

Number Verification

Codes
Message

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

Location

Codes
Message

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

Subaccount

Codes
Message

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

HLR

Status codes: PENDING (statusGrpId: 1)

The message has been processed and sent to the mobile operator.

statusId
Status

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.

UNDELIVERABLE (statusGrpId: 2)

The message was not delivered.

statusId
Status

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.

DELIVERED (statusGrpId: 3)

The message has been processed and successfully delivered.

statusId
Status

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.

EXPIRED (statusGrpId: 4)

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.

statusId
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.

REJECTED (statusGrpId: 5)

The message was received but was rejected by the operator.

statusId
Status

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.

Error Codes (HLR)

OK (errorGrpId: 0)

The request was successfully processed.

errorId
Permanent
Error

0

false

NO_ERROR

  • No error description provided. Usually returned for successful delivery or when no error code was returned by the operator.

HANDSET_ERRORS (errorGrpId: 1)

The request could not be completed due to issues related to the mobile handset.

errorId
Permanent
Error

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).

USER_ERRORS (errorGrpId: 2)

A user-related error occurred.

errorId
Permanent
Error

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.

OPERATOR_ERRORS (errorGrpId: 3)

The request could not be completed due to operator-side issues.

errorId
Permanent
Error

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)

Voice Message Sending / VMS

Codes
Message

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

Email Sending

Codes
Message

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

SMS Sending
SMS Cancellation
Status Retrieval
List of Statuses
Status Error Codes
Number Validation
Location
Sub-account
Voice Message Sending / VMS
Email Sending