> For the complete documentation index, see [llms.txt](https://bitel.gitbook.io/bitel/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bitel.gitbook.io/bitel/master/sms/single-sms.md).

# Single SMS

Send message to a single phone number

## 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**](/bitel/master/sms/sms-detail.md) API.
{% endhint %}