---
updatedAt: 2026-10-05T05:41:35.000Z
agentTools:
  projectIndex: https://developers.kaleyra.io/llms.txt
---

# SMS Status and Status Trace Codes

This document provides information about the status and status trace codes you would receive when executing the SMS REST APIs.

| Status        | Status Trace                | Description                                                                                                                                                                        |
| :------------ | :-------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| NOT-SENT      | NOTALLOWED                  | Country not enabled.                                                                                                                                                               |
| NOT-SENT      | NO-CREDITS                  | Insufficient credits.                                                                                                                                                              |
| NOT-SENT      | SERIES-BLOCK                | Mobile number series blocked.                                                                                                                                                      |
| NOT-SENT      | KLR-INV-NUMBER              | The recipient mobile number is invalid.                                                                                                                                            |
| Undelivered   | INV-NUMBER                  | The recipient mobile number is invalid.                                                                                                                                            |
| Undelivered   | SERVER-ERR                  | Server error.                                                                                                                                                                      |
| NOT-SENT      | SPAM                        | Spam SMS.                                                                                                                                                                          |
| NOT-SENT      | BLACKLIST                   | The mobile number to which you want to send is blacklisted.                                                                                                                        |
| NOT-SENT      | CON-DND                     | The Contact is marked as DND.                                                                                                                                                      |
| NOT-SENT      | INV-MOB-PATTRN              | The recipient mobile number is invalid.                                                                                                                                            |
| NOT-SENT      | TEMPLATE-NOT-FOUND          | Template not mapped.                                                                                                                                                               |
| NOT-SENT      | INV-TEMPLATE-MATCH          | Template not matching approved text.                                                                                                                                               |
| NOT-SENT      | SENDER-ID-NOT-FOUND         | Sender ID not found.                                                                                                                                                               |
| NOT-SENT      | NOT-OPTIN                   | Not subscribed for opt-in group.                                                                                                                                                   |
| NOT-SENT      | OUTPUT-REJ                  | Unsubscribed from the group.                                                                                                                                                       |
| NOT-SENT      | OPT-OUT                     | Message cannot be sent. Because the recipient has opted-out.                                                                                                                       |
| NOT-SENT      | REJECTED-MULTIPART          | Validation fail \[SMS over 160 characters].                                                                                                                                        |
| Undelivered   | SNDRID-NOT-ALLOTED          | No sender ID is allotted.                                                                                                                                                          |
| NOT-SENT      | DNDNUMB                     | DND registered number.                                                                                                                                                             |
| Undelivered   | INVALID-SUB                 | Number does not exist. Failed to locate the number in HLR database.                                                                                                                |
| Undelivered   | ABSENT-SUB                  | Telecom services not providing service for the particular number or Mobile Subscriber not reachable.                                                                               |
| Undelivered   | HANDSET-ERR                 | Problem with Handset or handset failed to get the complete message or Handset does not support the incoming messages.                                                              |
| Undelivered   | BARRED                      | End user has enabled message barring system or Subscriber only accepts messages from Closed User Group \[CUG].                                                                     |
| Undelivered   | NET-ERR                     | Operator of subscriber is not supported or Gateway mobile switching error.                                                                                                         |
| Undelivered   | MEMEXEC                     | Handset memory full.                                                                                                                                                               |
| Undelivered   | FAILED                      | SMS expired due to roaming limitation or Failed to process the message at operator level.                                                                                          |
| Undelivered   | MOB-OFF                     | Mobile handset in switched off mode.                                                                                                                                               |
| Undelivered   | HANDSET-BUSY                | Subscriber is in busy condition.                                                                                                                                                   |
| Undelivered   | SERIES-BLK                  | Series blocked by the operator.                                                                                                                                                    |
| Undelivered   | EXPIRED                     | SMS expired after multiple re-try.                                                                                                                                                 |
| Undelivered   | REJECTED                    | SMS rejected by operator.                                                                                                                                                          |
| Undelivered   | UNDELIV                     | Network issues.                                                                                                                                                                    |
| SENT - NO DLR | NO-DLR-OPTR                 | Sent.                                                                                                                                                                              |
| SENT - NO DLR | NO-DLR-OPTR-PROMO-IN        | Operators in India do not share a delivery report for submitted SMS which are sent to India  Promotional Route with Numerical Sender ID.                                           |
| Delivered     | DELIVRD                     | Message successfully delivered to the user.                                                                                                                                        |
| SUBMITTED     | ENROUTE                     | Message submitted to operator.                                                                                                                                                     |
| NOT-SENT      | MOB-NOTALLOWED              | Number not allowed for sender.                                                                                                                                                     |
| NOT-SENT      | NUM-LIMIT                   | Message-cap Overrun.                                                                                                                                                               |
| NOT-SENT      | DUPLICATE                   | SMS not sent as duplicate check limit exceeded.                                                                                                                                    |
| NOT-SENT      | BLOCKED-COUNTRY             | You are not allowed to send to this country as it is blocked for your account.                                                                                                     |
| Undelivered   | REJECTD                     | SMS Rejected by operator.                                                                                                                                                          |
| NOT-SENT      | INF-CREDIT                  | Insufficient credits.                                                                                                                                                              |
| NOT-SENT      | BILL-ERR                    | Bills service failed to respond.                                                                                                                                                   |
| Undelivered   | TL-NT-MTCHD                 | The template does not match the template registered on the DLT platform.                                                                                                           |
| Undelivered   | SDR-TL-MSMAT                | The sender ID used along with the template ID does not match the registration in DLT portal.                                                                                       |
| Undelivered   | TL-NT-FOUND                 | The message content sent was not found in the DLT platform as a registered template.                                                                                               |
| Undelivered   | TL-LMT-EXCED                | The variable content sent exceeds the allowed limit.                                                                                                                               |
| Undelivered   | TL-BLKLST                   | The message template pushed has been blacklisted at the DLT platform level.                                                                                                        |
| Undelivered   | TL-INACTIVE                 | The message template sent is in inactive status at the DLT platform level.                                                                                                         |
| NOT-SENT      | URL-SHRT-FAILED             | SMS not sent as URL shortening failed. Please contact support team at <support@kalerya.com>.                                                                                       |
| NOT-SENT      | URL-NT-SENT                 | SMS not sent as replaceable URL details not sent in API.                                                                                                                           |
| NOT-SENT      | URL-VAR-NT-FOUND            | SMS not sent as URL replaceable variable `{URL}` not found in the body.                                                                                                            |
| NOT-SENT      | KL-TEMPLATE-ID-NOT-FOUND    | SMS not sent as matching template ID not found for content.                                                                                                                        |
| NOT-SENT      | KL-TEMPLATE-ID-UNREGISTERED | SMS not sent as template ID is not registered.                                                                                                                                     |
| NOT-SENT      | KL-INV-CALLBACK             | Invalid callback object.                                                                                                                                                           |
| NOT-SENT      | KL-CALLBACK-URL             | URL field is mandatory in callback object.                                                                                                                                         |
| NOT-SENT      | KL-INV-CALLBACK-URL         | Invalid callback URL.                                                                                                                                                              |
| NOT-SENT      | KL-INV-CALLBACK-METHOD      | Method field is mandatory in callback object.                                                                                                                                      |
| NOT-SENT      | KL-INV-CALLBACK-METHOD-TYPE | Only GET and POST methods are allowed for callback.                                                                                                                                |
| NOT-SENT      | KL-INV-TEMPLATE-ID          | Invalid DLT template ID.                                                                                                                                                           |
| NOT-SENT      | KL-INV-ENTITY-ID            | Invalid DLT entity ID.                                                                                                                                                             |
| NOT-SENT      | KL-INV-BODY                 | Invalid message body.                                                                                                                                                              |
| NOT-SENT      | KL-INV-PORT                 | Invalid message port.                                                                                                                                                              |
| NOT-SENT      | KL-INV-UNICODE              | Invalid value for Unicode parameter.                                                                                                                                               |
| NOT-SENT      | KL-INV-FLASH                | Invalid value for flash parameter.                                                                                                                                                 |
| NOT-SENT      | KL-INV-URL-SHRTN-DATA       | Invalid url\_data input.                                                                                                                                                           |
| NOT-SENT      | KL-INV-REF                  | Invalid ref value.                                                                                                                                                                 |
| NOT-SENT      | KL-INV-REF1                 | Invalid ref1 value.                                                                                                                                                                |
| NOT-SENT      | KL-INV-REF2                 | Invalid ref2 value.                                                                                                                                                                |
| Undelivered   | INV-ENTIY-ID                | The Entity ID that customer used is Invalid.                                                                                                                                       |
| Undelivered   | PRFT-NT-MTCH                | This error code is received for Service Explicit content only. When the end-user is registered under DND. This is completely based on the DND preference selected by the end-user. |
| Undelivered   | SNDR-NT-REG                 | Sender ID is not registered in the DLT Platform.                                                                                                                                   |
| Undelivered   | TL-ID-INVLD                 | The template ID that customer using is Invalid.                                                                                                                                    |
| Undelivered   | SUBMIT-FAIL                 | Submission to Operator failed.                                                                                                                                                     |
| Undelivered   | SNDR-NT-REGD                | Sender ID is not registered in the DLT Platform.                                                                                                                                   |
| NOT-SENT      | MASKING-MISMATCH            | Message Content has Unicode or Mask parameters do not match body.                                                                                                                  |
| NOT-SENT      | TIME-OUT-PROM               | Marketing Campaign can only be sent from 10am to 9pm.                                                                                                                              |
| NOT-SENT      | MAX-LIMIT                   | The message could not be delivered as it exceeded maximum character limit.                                                                                                         |
| NOT-SENT      | CUTOFF-REACH                | Outside send window.                                                                                                                                                               |
| NOT-SENT      | SMS-LIMIT-REACHED           | SMS Not Sent as SMS-Limit has been reached.                                                                                                                                        |
| Sent - No DLR | SENT                        | Waiting for DLR.                                                                                                                                                                   |
| Undelivered   | SNDR-NT-MTCH                | Sender & entity mismatch.                                                                                                                                                          |
| NOT-SENT      | TOKEN-NOT-FOUND             | Token not found.                                                                                                                                                                   |
| Undelivered   | URL-NT-REG                  | URL not whitelisted.                                                                                                                                                               |
| Undelivered   | PE-BD-NT-REG                | PE bind not registered.                                                                                                                                                            |
| NOT-SENT      | KYC-NOT-APPROVED            | KYC not approved.                                                                                                                                                                  |
| Undelivered   | DNDNUM                      | DND registered number.                                                                                                                                                             |
| NOT-SENT      | BILL\_ERR                   | Bills service failed to respond.                                                                                                                                                   |
| Undelivered   | UNIDENTIFIED-SUB            | The subscriber could not be identified by the operator.                                                                                                                            |
| Undelivered   | ILLEGAL-SUB                 | The subscriber is not allowed to use the requested service due to regulatory or operator restrictions.                                                                             |
| Undelivered   | GATEWAY-ERROR               | An error occurred in the gateway.                                                                                                                                                  |
| Undelivered   | DLT-SCRUB-ERROR             | Message blocked due to DLT scrubbing failure.                                                                                                                                      |
| Undelivered   | TM-ID-NOT-REGISTERED        | The telemarketer ID is not registered on the DLT platform.                                                                                                                         |
| Undelivered   | TM-IN-ACTIVE                | The telemarketer ID is inactive on the DLT platform.                                                                                                                               |
| Undelivered   | TM-BLACKLISTED              | The telemarketer ID is blacklisted on the DLT platform.                                                                                                                            |
| NOT-SENT      | NO-CONSENT                  | No consent provided.                                                                                                                                                               |
| NOT-SENT      | CONSENT-NUMBER-DEACTIVATED  | Number deactivated.                                                                                                                                                                |
| NOT-SENT      | CONSENT-NOT-FOUND           | Consent not found.                                                                                                                                                                 |
| NOT-SENT      | CONSENT-API-ERROR           | Consent API failed.                                                                                                                                                                |
| NOT-SENT      | DEMO-MOB-NOTALLOWED         | Demo restriction.                                                                                                                                                                  |
| Undelivered   | KL-REQUEST-EXPIRED          | Request expired.                                                                                                                                                                   |
| Undelivered   | KL-CONFIG-NOT-FOUND         | Config not found.                                                                                                                                                                  |
| Undelivered   | KL-INTERNAL-BILL-API-FAILED | Billing API failed.                                                                                                                                                                |
| NOT-SENT      | GATEWAY-REJECT              | Gateway rejected.                                                                                                                                                                  |
| NOT-SENT      | SVC-EXP-TIME-OUT            | Promo service timeout.                                                                                                                                                             |
| Undelivered   | FCLT-NT-SUP                 | Recipient does not have an active SMS subscription.                                                                                                                                |