# SMS errors & error codes

**Status** is available for every SMS and visible in the Dashboard SMS overview. It is a generic value indicating the current SMS status, it focuses mostly on providing information on the SMS handling by the MessageBird platform. In case of delivery, failure Statuses do not provide any details nor can be used to determine what recipient numbers are valid and what aren't. 

**Status Reason** is available for every SMS and visible in the Dashboard SMS overview. It provides more details about the current SMS status.  The combination of status and Status Reason should provide enough information to manage and keep you updated on your receiver database (for example highlighting what numbers are incorrect and need to be purged)

***Error Code*****:** the most detailed level of information. Error Codes do NOT appear in the Dashboard but are visible via [API's Status Reports](https://developers.messagebird.com/api/sms-messaging/#handle-a-status-report). They are optional and are only populated if they are received from the downstream providers. Error codes provide the most information about a given failure as well specifying if it is **Intermediate** (the cause of the error is expected to / could resolve, retries are advisable) or **Permanent** (the cause of the error is definitive; the number should be removed from the client contact database) 

Both the detailed Status Reason List as well SMS Error code update list is available on our developer page.

You can find information about [API errors](https://developers.messagebird.com/docs/errors) and [SMS error codes](https://developers.messagebird.com/docs/smserrorcodes) and [SMS Status Reasons](https://developers.messagebird.com/api/sms-messaging/#sms-status-information-hierarchy) on our [Developer Resources webpage](https://developers.messagebird.com/).<br>


---

# Agent Instructions: 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:

```
GET https://docs.bird.com/connectivity-platform/troubleshooting/sms-errors-and-error-codes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.