# Send SMS (Multiple)

## Send SMS Request (Multiple)

<mark style="color:green;">`POST`</mark> `https://app.sleengshort.com/api/sms/send`

This endpoint allows you to send SMS to multiple users

Note the **msg\_ids** in the response body can be used to track the delivery status on a request when notifications are sent to the callback URL.

Also, you must check which API-Key you're using while sending sms. A <mark style="color:red;">coop API-Key</mark> must be used when sending sms with a <mark style="color:red;">coop sender\_id</mark> while an <mark style="color:red;">open API-Key</mark> must be used when sending sms with an <mark style="color:red;">open bind sender\_id.</mark>

#### Headers

| Name                                         | Type   | Description                                                                                           |
| -------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------- |
| sender id<mark style="color:red;">\*</mark>  | String | SMS sender ID                                                                                         |
| recipients<mark style="color:red;">\*</mark> | String | MSISDN of recipients in international format                                                          |
| msg<mark style="color:red;">\*</mark>        | String | SMS body ( < 905 characters)                                                                          |
| type                                         | String | Message format: 0: Flash SMS, 1: SMS delivers to inbox(default), 2: Unicode SMS – Chinese, Arabic etc |

{% tabs %}
{% tab title="200: OK Click to view samples" %}
```javascript
{
    "status": "ok",
    "description": "Request processed successfully",
    "msg_ids": "+23470370******|eae27c03-0092-4310-b99a-28daf06****,+23470370******|7c7cd1b2-228f-4091-bec4-2da61275****"
}
```



If you intend to send the same message to multiple recipients in a single request, separate each recipient with a comma “,” as seen in the sample JSON request body below.

{

<mark style="color:red;">"sender\_id" :</mark> <mark style="color:blue;">"TEST SENDER",</mark>

<mark style="color:red;">"recipients" :</mark> <mark style="color:blue;">"070\*\*\*\*\*\*\*\*,071\*\*\*\*\*\*\*\*,072\*\*\*\*\*\*\*\* ",</mark>

<mark style="color:red;">"msg" :</mark> <mark style="color:blue;">"Hello world!",</mark>

<mark style="color:red;">"type":</mark> <mark style="color:blue;">1</mark>

}
{% endtab %}

{% tab title="400: Bad Request Insufficient Balance" %}
```json
{
    "status": "Bad Request",
    "description": "The request could not be understood by the server due to malformed syntax",
    "data": {
        "err_msg": "Insufficient balance, fund your account"
    }
}
```
{% endtab %}
{% endtabs %}
