> For the complete documentation index, see [llms.txt](https://apidocs.api19.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.api19.com/numbers-ordering/change-call-forward.md).

# Change Call Forward

## GET or POST Request <a href="#get-or-post-request" id="get-or-post-request"></a>

{% hint style="info" %}
<https://v1.api19.com/dids/change/call\\_forward>
{% endhint %}

This changes the call forward for a specific number.

<table data-header-hidden><thead><tr><th width="184.6363525390625"></th><th width="165.09088134765625"></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Required</td><td>Type</td></tr><tr><td>did</td><td>yes</td><td>your phone number</td></tr><tr><td>call_forward</td><td>yes</td><td>forward number</td></tr><tr><td>key</td><td>yes</td><td>your API key</td></tr></tbody></table>

Set your call\_forward number to 0 to disable call forwarding. Call forwarding only supported to USA destinations.

{% tabs %}
{% tab title="Curl Post" %}

```php
curl -X POST https://v1.api19.com/dids/change/call_forward \
 -d 'did=3038821111' \
 -d 'call_forward=3038842222' \
 -d 'key=your-key'
```

{% endtab %}

{% tab title="JSON Response Success" %}

```json
{"status": "ok"}
```

{% endtab %}

{% tab title="JSON Response Error" %}

```json
{
    'status' => 'error',
    'error' => '{call_forward} is not a 10digit number',
    'code' => 'not_valid'
}
{
   'status' => 'error',
    'error' => 'No did found {did}',
    'code' => 'no_did'
}
{
   'status' => 'error',
    'error' => 'no ownership found {did}',
    'code' => 'no_owner'
}
{
   'status' => 'error',
    'error' => '{did} is a fax number. Convert to normal number first.',
    'code' => 'did_fax'
}
{
   'status' => 'error',
    'error' => 'You can't forward a number to itself',
    'code' => 'same_did'
}



```

{% endtab %}
{% endtabs %}