> 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/call/single-call.md).

# Single Call

Play mp3 for a single phone number

<mark style="color:green;">`POST`</mark> `https://api.bitel.rest/api/v1/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 The result contains the requestId" %}

```javascript
{
  "result": "d9478050b8794fca8018742d0556dc85",
  "error": null
}
```

{% endtab %}
{% endtabs %}

#### Sample Request

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

#### Error Codes

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

{% hint style="warning" %}
Make sure to store the requestId returned from the response
{% endhint %}
