# Batch P2P SMS

Peer to peer sms, where each message is sent to the corresponding message in the array.

{% hint style="warning" %}
The default gateway number doesn't deliver messages to black listed number, however a dedicated gateway number can be purchased to overcome this limitation.
{% endhint %}

## Get Cakes

<mark style="color:green;">`POST`</mark> `https://api.bitel.rest/api/v2/sms/batch/p2p`

#### Request Body

| Name          | Type   | Description                                                        |
| ------------- | ------ | ------------------------------------------------------------------ |
| gatewayNumber | string | Gateway number from which the SMS will be sent (up to 100 numbers) |
| messages      | array  | array of messages                                                  |
| phoneNumbers  | array  | array of phone numbers                                             |

{% tabs %}
{% tab title="200 " %}

```javascript
{
  "result": [
    {
      "id": "39011bf93c9d427fb853b441a73337da",
      "gatewayNumber": "10009909",
      "phoneNumber": "0912*******",
      "message": "Hello from Bitel!",
      "requestDate": 1564575254,
      "status": 0,
      "statusText": "Waiting",
      "partCount": 1,
      "price": 0.0
    },
    {
      "id": "8f0f3c9de6b2439aba6ba4a24e706a81",
      "gatewayNumber": "10009909",
      "phoneNumber": "0912*******",
      "message": "Hello from Bitel!",
      "requestDate": 1564575254,
      "status": 0,
      "statusText": "Waiting",
      "partCount": 1,
      "price": 0.0
    }
  ],
  "error": null
}
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Please not the number of messages should match the number of phone numbers
{% endhint %}

#### Sample Request

```javascript
{
    "messages": [
        "Hi"
    ],
    "phoneNumbers": [
        "0912*******"
    ],
    "gatewayNumber": "10007200" // optional
}
```

#### Sample Response

```javascript
{
  "result": [
    {
      "id": "39011bf93c9d427fb853b441a73337da",
      "gatewayNumber": "10009909",
      "phoneNumber": "0912*******",
      "message": "Hello from Bitel!",
      "requestDate": 1564575254,
      "status": 0,
      "statusText": "Waiting",
      "partCount": 1,
      "price": 0.0
    },
    {
      "id": "8f0f3c9de6b2439aba6ba4a24e706a81",
      "gatewayNumber": "10009909",
      "phoneNumber": "0912*******",
      "message": "Hello from Bitel!",
      "requestDate": 1564575254,
      "status": 0,
      "statusText": "Waiting",
      "partCount": 1,
      "price": 0.0
    }
  ],
  "error": null
}
```

{% hint style="info" %}

#### **Getting SMS Status**

In order to get the detail of a request, including the delivery status, price  and more please refer to [**Sms Status**](https://bitel.gitbook.io/bitel/sms/sms-detail)  API.
{% endhint %}

#### Error Codes

| Code           | Description                                                        |
| -------------- | ------------------------------------------------------------------ |
| InvalidRequest | Submitted data is invalid                                          |
| InvalidGateway | Gateway number is invalid, or the client doesn't have access to it |
