# Single Call

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

#### Request Body

| Name        | Type   | Description                                                                                    |
| ----------- | ------ | ---------------------------------------------------------------------------------------------- |
| phoneNumber | string | target phone number. example: 0912\*\*\*\*\*\*\*                                               |
| voiceId     | string | the identifier of the voice (refer to Upload File page)                                        |
| retryCount  | number | how many times the call is retried if the number if either busy or doesn't answer(default = 1) |
| serverId    | string | Identifier of dialer from which the voice will be originated                                   |

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

```javascript
{
  "result": {
    "id": "69b9e312e3b64b3880760639f5dfdffa",
    "phoneNumber": "0912*******",
    "status": "WAITING",
    "statusCode": 0,
    "billSec": 0,
    "requestDate": 1564640750,
    "executionDate": 0,
    "price": 0.0
  },
  "error": null
}
```

{% endtab %}
{% endtabs %}

#### Sample Request

```javascript
{
    "phoneNumber": "0912*******",
    "voiceId": "08e815cbcd724386805103ac0d45e4c2"
}
```

#### Sample Response

```javascript
{
  "result": {
    "id": "69b9e312e3b64b3880760639f5dfdffa",
    "phoneNumber": "0912*******",
    "status": "WAITING",
    "statusCode": 0,
    "billSec": 0,
    "requestDate": 1564640750,
    "executionDate": 0,
    "price": 0.0
  },
  "error": null
}
```

To understand the definition of the response, refer to [**Call Status**](https://bitel.gitbook.io/bitel/call/call-detail)

{% hint style="info" %}
Make sure to store the "id" of the response in order to get the call status
{% endhint %}

#### Error Codes

| Code           | Description                                       |
| -------------- | ------------------------------------------------- |
| InvalidRequest | Indicates that the submitted request is invalid   |
| InvalidServer  | Indicates that the selected server id is invalid� |
|                |                                                   |