SMS Delivery Report Error Codes

Delivery report events track the status of SMS messages from Airship’s 3rd-party providers to your audience. Delivery reports containing an error_code can help you understand why your message was not delivered to an audience member.

Error codes vary by vendor. Use the table relevant to your message vendor to determine the meanings of error codes.

Tyntec Error Codes

The following error_code values apply when the delivery report’s vendor property is TYNTEC.

 Note

Error codes are emitted by the vendor. The vendor may emit new error codes that are not documented here.

Error CodeDescription
001Message was successfully delivered.
002Message cannot be delivered.
006Message expired, i.e., the message could not be delivered within the specified time span.
010Message rejected, i.e., the message could not be delivered by our platform.
011Message could not be delivered. Tyntec is in the process of resending. Please wait for one of the above final statuses.
013Same as 010.
020Same as 010.

Sinch Error Codes

The following error_code values are relevant for SMS delivery report events when the vendor property is CLX. Sinch is the provider formerly known as CLX.

Some codes aren’t necessarily errors, and indicate that a message has not yet been delivered, most notably 400 (queued) and 401 (dispatched).

Example SMS Delivery Report with Sinch error_code
{
  "body": {
    "interaction_type": "delivery_report",
    "name": "dispatched",
    "properties": {
      "error_code": "401",
      "sender": 18587323362,
      "vendor": "CLX",
      "vendorDeliveryId": "ZLOiTjmZfV6r0-Eo"
    },
    "source": "API",
    "triggering_push": {
      "push_id": "7764f7bd-a206-4219-9933-a9bcb7dc9979"
    }
  },
  "device": {
    "channel": "73c29b53-a00a-4567-9ccd-1d726013699d",
    "delivery_address": "19712754475",
    "device_type": "SMS",
    "identifiers": {
      "sender": "18587323362"
    }
  },
  "id": "0f7d521f-dc6c-4530-9623-91fb8d370db5",
  "occurred": "2020-06-01T18:26:12.575Z",
  "offset": "1000032182771",
  "processed": "2020-06-01T18:26:13.558Z",
  "type": "CUSTOM"
}

 Note

Error codes are emitted by the vendor. The vendor may emit new error codes that are not documented here.

ErrorDescriptionCommentTreated as
0No error / Unknown errorTemporary
1Internal routing errorReport to AirshipPermanent
2Internal routing errorReport to AirshipPermanent
3Internal routing errorReport to AirshipPermanent
4Internal routing errorReport to AirshipTemporary
5Internal routing errorReport to AirshipPermanent
6Internal routing errorReport to AirshipPermanent
7Internal routing errorReport to AirshipPermanent
8Internal routing errorReport to AirshipPermanent
9Unsupported number planPermanent
10Unsupported type of numberPermanent
11Message not deliveredPermanent
12Dialing zone not foundPermanent
13Not home zone and IMSI not allowedPermanent
14Not home zone and IMSI fetch failedTemporary
15Screening blockPermanent
16Terminating IMSI blockedPermanent
17Destination network type unknownPermanent
18ESME errorTemporary
19Originating location mismatchPermanentPermanent
40Internal errorReport to AirshipTemporary
50Internal errorReport to AirshipTemporary
51Internal errorReport to AirshipTemporary
52Internal errorReport to AirshipTemporary
53Internal errorReport to AirshipPermanent
54Internal errorReport to AirshipPermanent
55Internal errorReport to AirshipPermanent
56Internal errorReport to AirshipTemporary
60Error, originator blockedPermanent
61Error, destination blockedPermanent
62Error, keyword blockedPermanent
63Error, SC address blockedPermanent
64Error, blocked due to exceeded quotaPermanent
65Error, loop detectedPermanent
66Error, data coding scheme blockedPermanent
67Error, information element identifier blockedPermanent
70Internal errorReport to AirshipTemporary
71Internal errorReport to AirshipTemporary
72Internal errorReport to AirshipPermanent
73Internal errorReport to AirshipTemporary
74Internal errorReport to AirshipTemporary
75Internal errorReport to AirshipTemporary
76Internal errorReport to AirshipTemporary
77IMSI lookup blockedPermanent
100Unidentified SubscriberPermanent
101Facility not supportedTemporary
102System failureTemporary
103Unexpected data valuePermanent
104Data missingPermanent
105Equipment protocol errorPermanent
106Unknown service center addressTemporary
107Service center congestionTemporary
108Invalid short message entity addressPermanent
109Subscriber not service center subscriberTemporary
110RejectIndicates temporary problem or lost reachPermanent
111Local CancelIndicates temporary problem or lost reachTemporary
112AbortIndicates temporary problem or lost reachTemporary
113Exception (internal)Report to AirshipPermanent
114Unknown errorTemporary
150Unknown subscriberMessage is rejected because there is no directory number for the mobile subscriberPermanent
151Call barredMessage is rejected due to barring of the MSPermanent
152Teleservice not provisionedMessage is rejected because the recipient MS has no SMS subscriptionPermanent
153Absent subscriberTemporary
154Facility not supportedThe message is rejected due to no provision of the SMS in the VPLMNPermanent
155System failureMessage rejected due to network or protocol failureTemporary
156Unexpected data valuePermanent
157Data missingPermanent
158Memory capacity exceededMessage rejected because the MS doesn’t have enough memoryTemporary
159Mobile subscriber not reachableTemporary
160RejectIndicates temporary problem or lost reachPermanent
161Local CancelIndicates temporary problem or lost reachTemporary
162AbortIndicates temporary problem or lost reachTemporary
163Exception (internal)Report to Airship (Local error)Permanent
164Unknown errorTemporary
200Unidentified subscriberTemporary
201Absent subscriber, IMSI detachedSubscriber is absent and have been for a period of timeTemporary
202Absent subscriber, no page responseThe message is rejected because there was no paging responseTemporary
203Subscriber busy for MT SMSThe message is rejected because of congestion encountered at the visited MSCTemporary
204Facility not supportedThe message is rejected due to no provision of the SMS in the destination SIMPermanent
205Illegal subscriberMessage rejected because of failed authenticationPermanent
206Illegal equipmentMessage rejected because the MS was black-listedPermanent
207System failureMessage rejected due to network or protocol failureTemporary
208Unexpected data valuePermanent
209Data missingPermanent
210Memory capacity exceededMessage rejected because the MS doesn’t have enough memoryTemporary
211Equipment protocol errorTemporary
212Equipment not short message equippedTemporary
213RejectIndicates temporary problem or lost reachPermanent
214Local CancelIndicates temporary problem or lost reachTemporary
215AbortIndicates temporary problem or lost reachTemporary
216Exception (internal)Report to AirshipPermanent
217Unknown errorTemporary
250Screening Error, personal service barring, MO Personal Determined Barring White ListPermanent
251Screening Error, personal service barring, MO Personal Determined Barring Black ListPermanent
252Screening Error, personal service barring, MO Operator Determined Barring White ListPermanent
253Screening Error, personal service barring, MO Operator Determined Barring Black ListPermanent
254Screening Error, personal service barring, MT Personal Determined Barring White ListPermanent
255Screening Error, personal service barring, MT Personal Determined Barring Black ListPermanent
256Screening Error, personal service barring, MT Operator Determined Barring White ListPermanent
257Screening Error, personal service barring, MT Operator Determined Barring Black ListPermanent
300Invalid destination addressPermanent
301Invalid destination numbering planPermanent
302Invalid destination type of numberPermanent
303Invalid destination flagPermanent
304Invalid number of destinationsPermanent
310Invalid source addressPermanent
311Invalid source numbering planPermanent
312Invalid source type of numberPermanent
320ESME Receiver permanent errorPermanent
321ESME Receiver reject errorPermanent
322ESME Receiver temporary error
330Invalid command lengthPermanent
331Invalid service typePermanent
332Invalid operationPermanent
333Operation not allowedPermanent
334Invalid parameterPermanent
335Parameter not allowedPermanent
336Invalid parameter lengthPermanent
337Invalid optional parameterPermanent
338Optional parameter missingPermanent
339Invalid validity parameterPermanent
340Invalid scheduled delivery parameterPermanent
341Invalid distribution listPermanent
342Invalid message classPermanent
343Invalid message lengthPermanent
344Invalid message referencePermanent
345Invalid number of messagesPermanent
346Invalid predefined messagePermanent
347Invalid priorityPermanent
348Invalid replace flagPermanent
349Request failedPermanent
350Invalid delivery report requestTemporary
360Message queue fullTemporary
361External errorReport to AirshipTemporary
362External errorReport to AirshipTemporary
370Cannot find informationTemporary
399UnknownTemporary
400QueuedMessage is queued within REST API system and will be dispatched according to the rate of the account.Send in progress
401DispatchedMessage has been dispatched to SMSC.Send in progress
402Message unroutableSMSC rejected message. Retrying is likely to cause the same error.Aborted
403Internal errorAn unexpected error caused the message to fail.Aborted
404Temporary delivery failureMessage failed because of temporary delivery failure. Message can be retried.Aborted
405Unmatched ParameterOne or more parameters in the message body has no mapping for this recipient.Aborted
406Internal ExpiryMessage was expired before reaching SMSC. This may happen if the expiry time for the message was very short.Aborted
407CanceledMessage was canceled by user before reaching SMSC.Aborted
408Internal RejectSMSC rejected the message. Retrying is likely to cause the same error.Aborted
410Unmatched default originatorNo default originator exists/configured for this recipient when sending message without originator.Aborted
411Exceeded parts limitMessage failed as the number of message parts exceeds the defined max number of message parts.Aborted
412Unprovisioned regionSMSC rejected the message. The account has not been provisioned for this region.Aborted

Sinch MMS Result/Error Codes

The following error_code/report_code values are relevant for MMS messages when delivery report’s vendor property is CLX. Sinch is the provider formerly known as CLX.

 Note

Error codes are emitted by the vendor. The vendor may emit new error codes that are not documented here.

CodeDescription
N101Message Sent
N102Message Sent/Delivered
E101Message Failed
E102Message Sent/Expired, Sent/Rejected, Sent/Failed or, Sent/Not Supported