Skip to content
Last updated

These errors relate specifically to 10DLC virtual numbers (only applicable for US numbers).

10DLC delivery report errors

These are error mapping codes for 10DLC virtual numbers:

StatusTypeError reasonDescription/example
15Screening errorScreening blocked the messageSubmit_SM : Spam - Spam Message Detected/Rejected
60Screening errorOriginator blockedCampaign is not in an "active" state. This means the campaign is in a state that doesn't allow messages to be sent (suspended, expired, etc.). Please contact your account manager for assistance in getting your campaign state resolved.
62Screening errorScreening blocked the messageMessage blocked by internal spam filtering
64Screening errorBlocked due to exceeded quotaSubmit_SM : Max Limit - Sending Limit Reached
152HLR errorTeleservice not provisionedService not available to subscriber/NAK returned
300ESME external errorInvalid destination address
310ESME external errorInvalid source address
321ESME external errorReceiver rejected error
332ESME external errorInvalid operationInvalid bind mode
334ESME external errorInvalid parameterInvalid source or destination sub-address. Example: Submit_SM : Invalid Tag Data (the message has invalid tagging data).
349ESME external errorRequest failedMessage invalid, routing failure, potentially blocked on AT&T
399ESME external errorUnknownLink unavailable, message blocked, late response, all other errors

Toll-free delivery report errors

These are error mapping codes for toll-free numbers in the US:

StatusTypeError reasonDescription/example
17Routing errorDestination network type unknownRoute denied
64Screening errorBlocked due to exceeded quotaToll-free number not verified. Daily, weekly, or monthly limit exceeded.
66Screening errorData coding scheme blockedInvalid data coding scheme
102SMSC errorSystem failureSystem error
150HLR errorUnknown subscriberPermanent resolution failure
152HLR errorTeleservice not provisionedDestination address is not text enabled
200MSC errorUnidentified subscriberSource carrier invalid or destination carrier invalid
205MSC errorIllegal subscriberSource not authorized
213MSC errorRejectTemporary resolution failure
255Screening errorPersonal service barring, MT Personal Determined Barring Black ListSPAM message detected/rejected
257Screening errorPersonal service barring, MT Personal Determined Barring Black ListUser opted out (STOP)
280Screening errorSM external control errorSource carrier disabled or destination carrier disabled
300ESME external errorInvalid destination address
301ESME external errorInvalid destination numbering planInvalid destination address numbering plan ( NPI )
302ESME external errorInvalid destination type of numberInvalid destination type of number (TON) or invalid destination address TON
303ESME external errorInvalid destination flag
304ESME external errorInvalid number of destinations
310ESME external errorInvalid source address
311ESME external errorInvalid source numbering planInvalid source address numbering plan ( NPI )
312ESME external errorInvalid source type of numberInvalid source TON or invalid source address TON
320ESME external errorReceiver permanent errorPermanent send error or ESME receiver permanent error
321ESME external errorReceiver reject errorESME receiver reject message error
322ESME external errorReceiver temporary errorESME receiver temporary error
331ESME external errorInvalid service typeInvalid service type, specified service type is unavailable, or specified service type is denied
332ESME external errorInvalid operationCancelling message failed, message query request failed, or insufficient credits to send message
333ESME external errorOperation not allowedTransaction delivery failure
335ESME external errorParameter not allowedTLV not allowed
336ESME external errorInvalid parameter length
337ESME external errorInvalid optional parameterError in the optional part of the PDU body, Invalid TLV value, Invalid source address subunit, or Invalid destination address subunit
338ESME external errorOptional parameter missingExpected TLV missing
339ESME external errorInvalid validityInvalid validity period value
340ESME external errorInvalid scheduled deliveryInvalid scheduled delivery time
341ESME external errorInvalid distribution listInvalid distribution list name or invalid submit to distribution list
342ESME external errorInvalid message classInvalid ESM class set
343ESME external errorInvalid message lengthValidation failed - empty message body or the message is too long
344ESME external errorInvalid message referenceMessage ID is invalid
345ESME external errorInvalid number of messages
347ESME external errorInvalid priorityInvalid priority flag
348ESME external errorInvalid replace flagMessage replacement failed, Invalid submit with replace request, or Invalid replace_if_present flag
349ESME external errorRequest failedSubmitting message has failed
350ESME external errorInvalid delivery report requestInvalid registered delivery flag
360ESME external errorMessage queue full
362ESME external errorThrottlingThrottling error
399ESME external errorUnknownPossible reasons:
  • Message rejected - status rejected
  • Message failed - reason unknown General failure DLR
  • Message expired
  • No valid route.
  • No handler found
  • Other unknown error.

Additional resources