> For the complete documentation index, see [llms.txt](https://developers.mobile-text-alerts.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.mobile-text-alerts.com/api-basics/error-response-codes.md).

# Error Response Codes

## HTTP Status Codes

Each API request returns an HTTP status code. This three-digit code indicates the request outcome. See [Error Message Catalog](/api-basics/error-response-codes/error-message-catalog.md) for detailed examples of errors you may encounter.

<table><thead><tr><th width="106">Code</th><th width="233"></th><th>Description</th></tr></thead><tbody><tr><td><mark style="color:green;"><code>200</code></mark></td><td><code>Success</code></td><td>Indicates a successful request and contains <a href="/spaces/M0P3gHFFZE4c6PMaPvHm/pages/w1yTw0X4c43P7dGeE176#response-headers">response headers</a> with additional details about the request.</td></tr><tr><td><mark style="color:red;"><code>400</code></mark></td><td><code>BadRequestError</code></td><td>Indicates that the request was malformed or invalid. Make sure you included all required fields for the endpoint in the request.</td></tr><tr><td><mark style="color:red;"><code>401</code></mark></td><td><code>UnauthorizedError</code></td><td>Indicates that the client is not authorized to access the requested resource. Make sure you include a valid <a href="/spaces/M0P3gHFFZE4c6PMaPvHm/pages/k3ETHPc9E4JPONyqqhqd#bearer-token-authentication">API key</a> in the request header.</td></tr><tr><td><mark style="color:red;"><code>403</code></mark></td><td><code>ForbiddenError</code></td><td>Indicates the client is authenticated but not authorized to access the requested resource.</td></tr><tr><td><mark style="color:red;"><code>429</code></mark></td><td><code>RateLimitError</code></td><td>Indicates too many requests to the server within a window of time, exceeding the allowed <a href="/spaces/M0P3gHFFZE4c6PMaPvHm/pages/axCIvJXLW8bxBKiqKpuZ">rate limit</a> for that endpoint.</td></tr><tr><td><mark style="color:red;"><code>500</code></mark></td><td><code>InternalServerError</code></td><td>Indicates the server encountered an unexpected error that prevented it from fulfilling the request. This usually means there is an issue with the server, not the request.</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://developers.mobile-text-alerts.com/api-basics/error-response-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.
