> For the complete documentation index, see [llms.txt](https://help.clickatell.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.clickatell.com/developers-api-reference/developers-archive/sms-rest-api-overview/api-error-codes.md).

# API error codes

The following error messages are generated by the Clickatell gateway during the validation phase by our REST, FTP, SMTP, and SOAP APIs before a message is accepted. These error messages are sent back to your application as API responses. There will be no message charge if these errors are generated when sending a message. Data regarding messages that don’t pass initial validation will not be included in your Developers’ Central reports.

<table><thead><tr><th>Error Code</th><th width="163.79998779296875">Description</th><th width="207.60003662109375">Detailed Description</th><th width="261.4000244140625">Solution</th></tr></thead><tbody><tr><td><strong>001</strong></td><td>Authentication failed</td><td>Authentication details are incorrect.</td><td></td></tr><tr><td><strong>007</strong></td><td>IP lockdown violation</td><td>You have locked down the API instance to a specific IP address but attempted to send from an IP address different to the one you have set.</td><td>You can edit the setting to include your new server’s IP address or remove the IP lockdown completely within Developers’ Central’s API settings.</td></tr><tr><td><strong>100</strong></td><td>Data malformed</td><td>The JSON/XML data submitted is invalid.</td><td>Check that the syntax of your request has been formulated correctly and resubmit.</td></tr><tr><td><strong>101</strong></td><td>Invalid or missing parameters</td><td>One or more parameters are missing or invalid.</td><td></td></tr><tr><td><strong>102</strong></td><td>Invalid user data header</td><td>The format of the user data header is incorrect.</td><td>Ensure valid UDH data is being passed to the API.</td></tr><tr><td><strong>105</strong></td><td>Invalid destination address</td><td>The destination address you are attempting to send to is invalid.</td><td>Check that the number of the handset that you are attempting to send a message to is valid. The number should be in an international format, without a ‘ 00’ prefix or leading ‘+’ symbol OR begin with a ‘0’ if the default country prefix is enabled on your API.</td></tr><tr><td><strong>106</strong></td><td>Invalid source address</td><td>The specified sender address is incorrect.</td><td>The address that the message is sent ‘from’ has been specified incorrectly. If you are using a Sender ID as your source address, ensure that it has been registered within your online Developers’ Central account.</td></tr><tr><td><strong>108</strong></td><td>Invalid or missing API ID</td><td>The API ID is either incorrect or has not been included in the API call.</td><td>Include the correct API product ID in your query. You can check the ID that is associated with your API by logging into your Developers’ Central account.</td></tr><tr><td><strong>109</strong></td><td>Missing message ID</td><td>This may refer to either a client message ID or API message ID – for example, when using the ‘stop message’ command.</td><td></td></tr><tr><td><strong>113</strong></td><td>Maximum message parts exceeded</td><td>The text component of the message is greater than the permitted 160 characters (70 Unicode characters). </td><td>Set concat equal to 1,2,3-N to overcome this by splitting the content across multiple messages. </td></tr><tr><td><strong>114</strong></td><td>Cannot route message</td><td>This implies that the gateway is not currently routing messages to this network prefix. Please email <a href="mailto:support@clickatell.com">support@clickatell.com</a> with the mobile number in question.</td><td></td></tr><tr><td><strong>116</strong></td><td>Invalid unicode data</td><td>The format of the Unicode data entered is incorrect.</td><td>Ensure that the Unicode format is correct and resubmit your query.</td></tr><tr><td><strong>120</strong></td><td>clientMessageId contains space(s)</td><td>Your specified client message ID contains a space. Space characters in client message IDs are not currently supported.</td><td>The delivery time must be entered in minutes up to a maximum of 7 days.</td></tr><tr><td><strong>121</strong></td><td>Destination mobile number blocked</td><td>This number is not allowed to receive messages from us and has been put on our blocked list.</td><td></td></tr><tr><td><strong>122</strong></td><td>Destination mobile opted out</td><td>The user has opted out and is no longer subscribed to your service.</td><td></td></tr><tr><td><strong>123</strong></td><td>Invalid Sender ID</td><td>The sender ID is not valid or has not been approved. </td><td>A sender ID needs to be registered and approved before it can be successfully used in message sending.</td></tr><tr><td><strong>128</strong></td><td>Number delisted</td><td>This number has been delisted and cannot receive our messages.</td><td></td></tr><tr><td><strong>130</strong></td><td>Maximum MT limit exceeded until &#x3C;UNIX TIMESTAMP></td><td>This error is returned when an account has exceeded the maximum number of MT messages that can be sent daily or monthly. You can send messages again on the date indicated by the UNIX TIMESTAMP.</td><td></td></tr><tr><td><strong>160</strong></td><td>HTTP method is not supported on this resource</td><td>An unsupported HTTP method has been performed on the resource. Example: HTTP POST on the Coverage resource.</td><td>The response MUST include a Content-Type header that contains a valid method for the requested resource.</td></tr><tr><td><strong>161</strong></td><td>Resource does not exist</td><td>You are attempting to access a REST API resource that does not exist.</td><td></td></tr><tr><td><strong>165</strong></td><td>Invalid or no version header specified</td><td>The expected header that specifies version was either not found or is invalid.</td><td>Before continuing, make sure that the correct version is included in the submitted header. The header to use is <code>X-Version: 1</code></td></tr><tr><td><strong>166</strong></td><td>Invalid accept header specified</td><td>The optional header that specifies acceptable content does not contain an allowed value.</td><td></td></tr><tr><td><strong>167</strong></td><td>Invalid or no content-type specified</td><td>The expected header that specifies content-type content was either not found or did not contain an allowed value.</td><td>Before continuing, make sure that an allowed value is included in the submitted content-type header. The allowable content-type header values are ‘application/json’ or application/xml’.</td></tr><tr><td><strong>250</strong></td><td><p>Destination address is on DNC list - Do not contact receiver</p><p><br></p></td><td>DNC lookup for the destination address result shows that the receiver should not be contacted.</td><td>Use the “bypass_dnc_check” (this name varies for APIs) request parameter to bypass the DNC check.</td></tr><tr><td><strong>301</strong></td><td>No credit left</td><td>Insufficient credits.</td><td>Log in to your Developers’ Central account and purchase additional credits.</td></tr><tr><td><strong>901</strong></td><td>Internal error - please retry</td><td>An error occurred on our platforms.</td><td>Please retry submitting the message. This should be exceptionally rare.</td></tr></tbody></table>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.clickatell.com/developers-api-reference/developers-archive/sms-rest-api-overview/api-error-codes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.