Skip to content

Status & Error Codes

MMS Message Statuses

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.
2501 Invalid destination address Phone-number/recipient is invalid.
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
2517 ExpiryDate is invalid Expiry date is an invalid date or the date is in the past.
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
2552 API access is blocked for this account. Please check the status of this account or its master account if applicable.
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 sender address may be incorrect or not provisioned in the country of recipient number
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.
2571 DisplayOnly Attribute Error displayOnly=true cannot be set for all Numbers in the request.
2572 DisplayOnly Attribute Error displayonly=false attribute can be set only once in the request.
2573 DisplayOnly Attribute Error displayOnly attribute contains only true and false value.
2574 SenderAddress Error Only Shortcode or RFC2822Address nodes are supported under SenderAddress node
2575 SenderAddress Error Alphanumeric Sender is not provisioned.
2576 RFC2822Address DisplayOnly Attribute Error Support RFC2822Address for group messaging only with displayonly = true
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
3520 Provisioning issue Provisioning problem, please contact your account manager
4000 General service error Carrier rejects the message due to a general service error
4002 Unsuported MM7 version The carrier doesn’t support this MM7 version
4003 Unsupported operation Carrier rejects the message due to unsupported operation or format
4004 Validation error Validation error
4006 Service unavailable Carrier capacity reached. Retry later
4007 Service denied Carrier denies service for the recipient address
5001 Transcoding failed Audio/Video transcoding failed. This error occurs during transcoding process.
5002 Transcoded request generation error New request file with transcoded content not generated successfully. This error occurs during transcoding process.
5003 Content Parsing Error Content parsing failed from MM7 request. This error occurs during transcoding process.
5004 Transcoded Content Size Error Total size of the transcoded size is greater than the operator binary size allowed. This error occurs during transcoding process.
5005 MM7 Request File Fetch Error MM7 request file doesn’t exist or the file is empty.

HTTP Status Codes

In addition to the MM7 status codes listed above, the endpoint returns HTTP status 401 Unauthorized when authentication credentials are missing or invalid. This applies to MM7 API requests and to the MM7 MO endpoint. Treat a 401 as an authentication failure and do not retry the request until the credentials have been corrected.

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
3000 System error Internal system/service error.
3510 Throughput exceeded Throughput exceeded please retry later