Skip to end of metadata
Go to start of metadata

Last Updated: Wednesday, September 19, 2018



Any request that is invalid, or has a problem, will return the appropriate HTTP Responses. The Error Response XML outlined below will be returned in the body of the reply.

HTTP Status Code

Error Code

Description

Retriable

200

0

Success

False

500

1000

General Processing Error. '%exception%'

False

500

1001

Processing error while handling request.

True

509

1002

Throughput exceeded. Try again later.

True

401

1010

Invalid User/Password.

False

403

1011

User not authorized to send MT messages from Shortcode.

False

400

1020

Invalid Request Format/content.

False

400

1022

Request attribute '%name%' has invalid value '%value%'.

False

413

1023

Max Limit on Destinations exceeded.

False

4131023Message Size %length%, exceeded maximum allowed: 500KB.False

404

1024

Resource Not Found.

False

406

1025

Shortcode not provisioned on Carrier.

False

415

1026

Request Media Type not Supported, Supported Media Types: '%values%'.

False

422

1027

Premium messaging is not supported on this shortcode.

False

422

1028

Request attribute '%name%': '%value%' could not be processed.

False

403

1029

Company not authorized to send MT messages from Shortcode.

False

403

1030

User not authorized to send for Company.

False

422

1031

%mdn% is not a mobile phone number or its carrier [%spid%] is currently not supported.

False

4221032Message text length [%length%] exceeds 160 characters.False
4221033Alternate Delivery is not supported for multipart messages.False
4051034Method Not Allowed.False

This is the list of errors that can occur during processing a request. While this list is kept up to date, the list is not exhaustive and future errors can be added.

Certain error codes indicate that a request can be retried. It is permissible and advisable that the request can be retried again later, as the error was transient in nature and may have cleared.

Error XML Response Example

<error code="1" description="Error Code Reason" retriable="true" />
  • No labels