> 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/delete-numbers.md).

# Delete Numbers

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

{% hint style="info" %}
<https://v1.api19.com/dids/delete>
{% endhint %}

Send us a GET or POST request with your key and the number (in the URI as key or as http password)

This deletes your number from your account.

| Argument | Required | Type |
| -------- | -------- | ---- |
| number   | yes      | int  |

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

```php
curl -X POST https://v1.api19.com/dids/delete \
 -d 'number=3038821111' \
 -d 'key=your-key'
```

{% endtab %}

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

```php
{
    "status": "ok"
}
```

{% endtab %}

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

```json
{
    'status' => 'error',
    'error' => 'DID is required',
    'code' => 'missing_did'
}

{
    'status' => 'error',
    'error' => 'Invalid DID',
    'code' => 'invalid_did'
}

{
    'status' => 'error',
    'error' => 'Cannot find did',
    'code' => 'mssing_data'
}

{
    'status' => 'error',
    'error' => 'DID does not exist',
    'code' => 'missing_db'
}

{
    'status' => 'error',
    'error' => 'Number not available',
    'code' => 'no_availability'
}

{
    'status' => 'error',
    'error' => 'Number not available {did}',
    'code' => 'did_not_available'
}




```

{% endtab %}
{% endtabs %}