# Call end

## Create an end call

<mark style="color:green;">`POST`</mark> `https://{{account_id}}.acquire.io/api/v1/voip/call-end`

Create an ended call.

#### Request Body

| Name                                           | Type   | Description                                                                                                      |
| ---------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------- |
| Email<mark style="color:red;">\*</mark>        | string | Email of the callee. Email is optional for an incoming call.                                                     |
| From<mark style="color:red;">\*</mark>         | string | Phone number of the caller                                                                                       |
| To<mark style="color:red;">\*</mark>           | string | Phone number of the callee                                                                                       |
| CallId<mark style="color:red;">\*</mark>       | string | ID of the call.                                                                                                  |
| CallStatus<mark style="color:red;">\*</mark>   | string | <p>Specify the status of the call. <br>\['busy',<br>'no-answer',<br>'canceled',<br>'failed',<br>'completed']</p> |
| RecordingUrl<mark style="color:red;">\*</mark> | string | Specify the URL of the recording.                                                                                |
| Duration<mark style="color:red;">\*</mark>     | string | Specify the call duration (sec).                                                                                 |
| Direction<mark style="color:red;">\*</mark>    | string | Specify the direction of the call. 'outgoing' \| 'incoming'                                                      |

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

```
{
  "data": {
    "success": true,
    "message": "Successfully saved"
  }
}
```

{% endtab %}
{% endtabs %}

**Body (raw)**

```
{
  "From": "+1234567890",
  "To": "+1789451230",
  "CallId": "CA12345678904567890",
  "email": "user@example.com",
  "CallStatus": "completed",
  "RecordingUrl": "string",
  "Duration": "10",
  "Direction": "incoming"
}
```