# Single SMS

## SMS Single

<mark style="color:green;">`POST`</mark> `https://api.bitel.rest/api/v1/sms/single`

#### Request Body

| Name          | Type   | Description                                    |
| ------------- | ------ | ---------------------------------------------- |
| gatewayNumber | string | Gateway number from which the SMS will be sent |
| message       | string | Message ex. "Hi there"                         |
| phoneNumber   | string | User phone number ex. 0912xxxxxxx              |

{% tabs %}
{% tab title="200 result contains the requestId(refer to SMS Detail page)" %}

```javascript
{
    "result": {
        "requestId": "963551a72f794190ad4fc42fed01aabc",
    },
    "error": null
}
```

{% endtab %}
{% endtabs %}

#### Sample Request

```javascript
{
    "message": "Hi there",
    "phoneNumber": "0912*******",
}
```

#### Error Codes

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

{% hint style="info" %}

## Getting SMS Detail

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