---
metadata:
  - name: generator
    content: Diplodoc Platform v5.15.5
alternate:
  - https://delivery.yango.com/docs/en/api/express/openapi/IntegrationV2DriverVoiceForwarding.md
---
> **Documentation Index:** Fetch the complete configuration index at https://delivery.yango.com/docs/en/llms.txt

<div class="openapi">

# Courier's phone number

Returns the courier's phone number, who is currently fulfilling the claim.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method} 
```text translate=no
b2b.delivery.yango.tech/b2b/cargo/integration/v2/driver-voiceforwarding
```



</div>

Service URL

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}


```json translate=no
{
    "claim_id": "string",
    "point_id": 372036854775807
}
```


{% endcut %}


#|||
 **Name** 
|
 **Description** 
||

||
 claim_id<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Claim ID received at the claim creation stage 
||

||
 point_id {.openapi-table-parameter-name} 
|
 **Type:** integer&lt;int64&gt;

Integer point ID (int64) generated on the Yango Delivery side.
It is in the route_points[].id field. Applicable to source, destination, and return points.

*Example:*{.openapi-description-annotation} `372036854775807`
 
|||#{.openapi-table}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}


```json translate=no
{
    "phone": "+97142773333",
    "ext": "0163",
    "ttl_seconds": 2088
}
```


{% endcut %}


#|||
 **Name** 
|
 **Description** 
||

||
 ext<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Extension number

*Example:*{.openapi-description-annotation} `0163`
 
||

||
 phone<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Phone number

*Example:*{.openapi-description-annotation} `+97142773333`
 
||

||
 ttl_seconds<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** integer&lt;int64&gt;

Time during which this phone number is operational (int64)

*Example:*{.openapi-description-annotation} `2088`
 
|||#{.openapi-table}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Incorrect phone number

<div class="openapi-entity">

### Body

{% cut "application/json" %}


```json translate=no
{
    "code": "invalid_point_phone",
    "message": "Incorrect phone number"
}
```


{% endcut %}


#|||
 **Name** 
|
 **Description** 
||

||
 code<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Error code

*Example:*{.openapi-description-annotation} `invalid_point_phone`

*Enum:*{.openapi-description-annotation} `invalid_point_phone`
 
||

||
 message<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Error description

*Example:*{.openapi-description-annotation} `Incorrect phone number`
 
|||#{.openapi-table}

</div>

</div>

<div class="openapi__response__code__404">

## 404 Not Found

Claim or order executor not found

<div class="openapi-entity">

### Body

{% cut "application/json" %}


```json translate=no
{
    "code": "not_found",
    "message": "Claim not found"
}
```


{% endcut %}


#|||
 **Name** 
|
 **Description** 
||

||
 code<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Error code

*Example:*{.openapi-description-annotation} `not_found`

*Enum:*{.openapi-description-annotation} `not_found`
 
||

||
 message<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Error description

*Example:*{.openapi-description-annotation} `Claim not found`
 
|||#{.openapi-table}

</div>

</div>

<div class="openapi__response__code__409">

## 409 Conflict

Order completed

<div class="openapi-entity">

### Body

{% cut "application/json" %}


```json translate=no
{
    "code": "inappropriate_status",
    "message": "Invalid action regarding the claim"
}
```


{% endcut %}


#|||
 **Name** 
|
 **Description** 
||

||
 code<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Error code

*Example:*{.openapi-description-annotation} `inappropriate_status`

*Enum:*{.openapi-description-annotation} `inappropriate_status`
 
||

||
 message<span class="openapi__required">*</span> {.openapi-table-parameter-name} 
|
 **Type:** string

Error description

*Example:*{.openapi-description-annotation} `Invalid action regarding the claim`
 
|||#{.openapi-table}

</div>

</div>
<!-- markdownlint-disable-file -->

</div>



[*Deprecated]: No longer supported, please use an alternative and newer version.