> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beem.africa/llms.txt
> Use this file to discover all available pages before exploring further.

# API responses

> HTTP status codes and platform response codes for Multicountry SMS send operations.

The Multicountry SMS HTTP API returns standard HTTP status codes. For successful HTTP requests, the **response body** carries additional status information — including failures that still return **HTTP 200**.

***

## HTTP status codes

| HTTP status | Typical cause                                              |
| ----------- | ---------------------------------------------------------- |
| `200`       | Request received — check response body for platform status |
| `400`       | Bad request — missing authorization or malformed request   |
| `401`       | Authentication failed                                      |

### Authentication error example

```json theme={null}
HTTP/1.1 401 Unauthorized
{
  "error": "Authentication failed"
}
```

### Missing authorization example

```json theme={null}
HTTP/1.1 400 Bad Request
{
  "error": "You do not have api permission"
}
```

***

## Platform status in HTTP 200 body

When HTTP status is **200**, the body may still indicate failure:

**Plain text failure (message ID `-1`):**

```text theme={null}
-1
-2
Recipient (DESTADDR) is missing
```

**Plain text success:**

```text theme={null}
124365
0
OK
```

### Common platform status codes

| Code | Meaning                                    |
| ---- | ------------------------------------------ |
| `0`  | Success                                    |
| `1`  | Unknown error                              |
| `2`  | Syntax error / missing mandatory parameter |
| `10` | Access denied                              |
| `11` | Invalid message                            |
| `16` | No message credits left                    |

See [Sending messages](/guides/multicountry-sms/sending-messages#common-status-codes) for JSON and XML response formats.

***

## Related

* [Sending messages](/guides/multicountry-sms/sending-messages)
* [SMPP error codes](/guides/multicountry-sms/smpp-error-codes)