Status Codes

Reference for all delivery status and error codes returned by TeamMessage. These codes appear in delivery reports and the SMS log.

SMS Status Codes

The status code indicates the delivery state of an SMS message:

Code Status Description
-1 Delivered SMS successfully sent
0 Delivered SMS successfully delivered to recipient
1 Buffered SMS buffered in carrier's system (SMSC)
2 Failed SMS delivery failed
3 Accepted SMS submitted to carrier, awaiting delivery report
1001 Buffered SMS buffered in SMSC
1002 Failed SMS could not be delivered yet
1003 Failed SMS could not be delivered for multiple days

Common Reason Codes

Reason codes provide additional detail about failures. Here are the most common ones:

Invalid Number

Code Reason
-13 Invalid mobile number format
-12 Number from unsupported network
-2 Invalid mobile number
0 Unknown subscriber (number not found)
101 Unknown subscriber MSISDN
206 Invalid destination address – rejected by carrier

Subscriber Unavailable

Code Reason
107 Phone turned off or out of coverage
160 Subscriber temporarily unreachable (roaming)
162 Device not responding
512 Message expired – not delivered within validity period

Delivery Blocked

Code Reason
103 Call barred – delivery blocked by carrier
104 Operation barred by carrier
517 SMS blocked due to unauthorized content
518 Destination not allowed for this account
623 Destination blacklisted

Technical Errors

Code Reason
1-8 Service temporarily not available
10 Network timeout
50 Delivery failed – could not reach device
105, 109, 113 Service center congestion
118 System failure in destination network

Account Issues

Code Reason
622 Insufficient credit (prepaid)
1628 Invalid account
1662 Throttling error – rate limit exceeded

Voice Call Status (SIP)

For SMS-to-Voice (text-to-speech calls), these SIP response codes are used:

Code Status Description
200 OK Call answered, message delivered successfully
404 Not Found Number unknown
408 Timeout No answer – timeout
480 Unavailable Temporarily unavailable
486 Busy Line busy
487 Terminated Call terminated
488 Not Acceptable Codec problem
604 Does Not Exist Number does not exist

Note

Voice calls are retried automatically if not answered. The status field shows the number of attempts.

Status Groups

In the SMS log, delivery statuses are grouped into three categories:

Group Color Meaning
Success ● Message delivered to recipient
Pending ● Waiting for delivery confirmation from carrier
Failed ● Delivery failed – check reason code for details

API Response Codes

The Legacy HTTP API returns these response codes:

Code Meaning
+1 Success – SMS accepted for delivery
-1 Invalid team ID
-2 Invalid team name
-3 Invalid sender email
-4 Message too short
-5 No message provided
-10 Account not found
-11 SMS sending locked
-12 IP address not in whitelist

See Legacy HTTP for complete API documentation.

Troubleshooting by Code

Common issues and their solutions:

Code 0 / 101: Unknown subscriber

  • Verify the phone number is correct
  • The number may have been disconnected
  • Try with the international format (+49...)

Code 107: Phone off or no coverage

  • The recipient's phone is switched off
  • Message will be delivered when phone is back online (within validity period)

Code 512: Message expired

  • The message validity period expired before delivery
  • Default validity is 48 hours
  • Recipient's phone was off for too long

Code 622: Insufficient credit

  • Top up your SMS credit
  • Check your balance in the portal

For more help, see Troubleshooting.

Menu