The following table lists the responses returned with delivery reports.
Status
Status text
Description
Deferred
Deferred
The handset has retrieved the MMS header but has not downloaded the full message from the mobile network. The handset may still download the message at a later time.
Expired
Expired
The handset did not retrieve the message before the message expiration time.
Forwarded
Forwarded
The message has been sent successfully to the mobile network.
Indeterminate
Indeterminate
The mobile network could not determine if the message was delivered correctly.
NotSupported
NotSupported
The request made to the MMS gateway is not supported
Rejected
Rejected
The message has been rejected by the MMS gateway or mobile network.
Retrieved
Success
The message was successfully delivered to the handset and the handset was configured to acknowledge the message with a delivery receipt.
Unreachable
Unreachable
The destination network or the mobile subscriber cannot be reached.
Unrecognized
Unrecognized
The handset of the mobile subscriber does not recognize the message content.
MMS Error Codes
Status code
Status text
Details
1000
Success
Successfully parsed and validated request.
2000
Client error
Invalid IP Address or Protocol
2002
Address Error
Invalid Address
2004
Multimedia refused
Carrier refuses content
2007
Unable to parse request
Message format corrupt
2500
Missing or Invalid HTTP header Content-Length or Content-Type
Ensure the HTTP Content-Length and Content Type header are included and valid.
2502
Missing destination address
Ensure the recipient is specified correctly for the MM7 version that is used.
2503
Multiple destination addresses not supported
Multiple recipients not supported. Instead, create multiple messages
2504
Missing source address
Ensure source address is specified correctly for the MM7 version that is used
2505
Missing or unsupported MM7 Version
Ensure specified MM7 version is on the list of supported versions, and is in the format x.y.z
2506
Missing XML element – Content
Ensure the Content element is included in the SubmitRequest.
2507
Unsupported namespace
Ensure that all the namespaces specified are on the list of supported namespaces.
2510
Missing or Invalid SOAP header
Ensure the SOAP envelope contains a SOAP header with only the TransactionID element
2511
Missing or Invalid SOAP body
Ensure the SOAP envelope contains a SOAP body with the SubmitReq
2512
Unsupported operation
SubmitReq is the only supported operation
2513
Unable to parse attachment
Ensure your attachment is specified, and encoded properly
2514
Invalid SOAP attachment header Content-Type
Ensure the Content-Type headers of all the attachments are formatted properly
2515
Invalid SOAP body part Content-Type
Ensure the Content-Type header of the SOAP body part, aka the SOAP envelope part, is formatted properly
2550
Account disabled
Your account is no longer provisioned for MMS
2551
Account not Provisioned for MM7
Your account is not provisioned for MM7 API
2560
Content length exceeded maximum supported request size
Reduce the size of the content you are sending.
2561
Invalid sender identification
Sender identification invalid or missing.
2562
Invalid VASID
The VASID is your ServiceID
2563
Invalid source address
The Shortcode may be incorrect or not provisioned
2564
Invalid VASPID
The VASPID is your API Key
2566
Invalid carrier
Invalid carrier ID.
2567
Missing carrier ID
Carrier ID is required to be passed
2568
Unable to authenticate
Ensure the HTTP username and password you have specified are correct and formatted properly within the Authorization header.
2569
Carrier Lookup Failed. Please retry.
The carrier lookup server is not responding. Please retry again.
2570
Carrier Not Provisioned
This carrier is not provisioned in the system.
3000
System error
Internal system/service error.
3001
Number blacklisted
Phone number is blacklisted for receiving messages do not retry.
3510
Throughput exceeded
Throughput exceeded please retry later.
Retry Error Codes: 2569, 3000 and 3510
Status Code
Status Text
Details
2569
Carrier Lookup Failed. Please retry.
The carrier lookup server is not responding. Please retry again.