HTTP Response Codes

📘

Note

While this list is kept up to date, the list is not exhaustive and future errors can be added.

Certain response codes indicate that a request can be retried. If the error is retryable, it means that the error was temporary and may resolve itself on its own. In this case, we recommend you try again later.

Error Codes from the HTTP API

Below you can find a reference chart of the status and error codes that will be returned in the body of the reply and what they mean.

HTTP Status Code

Error Code

Description

Retryable?

200

0

Success

False

500

1000

General Processing Error. '%exception%'

False

500

1001

Processing error while handling request.

True

429

1002

Throughput exceeded. Try again later.

True

401

1010

Invalid User/Password.

False

403

1011

User not authorized to send MT messages from code.

False

400

1020

Invalid request format/content.

False

400

1022

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

False

413

1023

Message Size %Value%, exceeded maximum allowed: %limit%

False

404

1024

Resource not found.

False

406

1025

Code 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 code.

False

422

1028

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

False

403

1029

Company not authorized to send MT messages from the provided code.

False

403

1030

User not authorized to send message for this company.

False

422

1031

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

False

422

1032

Message text length [%length%] exceeds 160 characters.

False

422

1033

Alternate message delivery (available for v3.1+ only) is not supported for multipart messages.

False

405

1034

Method not allowed.

False

Example Response

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

Delivery Receipts

See Delivery Receipt Response Codes for more information.