> 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/vanity-toll-free-order.md).

# Vanity Toll Free - Order

## GET or POST Request

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

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

This will immediately attempt to order numbers. You can send the dids field as either a comma list of the numbers OR a json object of the numbers

| Argument | Required | Type |
| -------- | -------- | ---- |
| dids     | yes      | int  |
| callflow | no       | int  |
| faxflow  | no       | int  |

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

```php
curl -X POST https://v1.api19.com/dids/tfvanity/order \
 -d 'dids=3038821111,3038883333' \
 -d 'callflow=444' \
 -d 'key=your-api-key'
 
OR

curl -X POST https://v1.api19.com/dids/tfvanity/order  \
 -d 'dids=[3038821111,3038883333]' \
 -d 'callflow=444' \
 -d 'key=your-api-key'

```

{% endtab %}
{% endtabs %}

Responses

Your cart\_order number has debugging information, if you have any issues, you can open a ticket with this number.

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

```javascript
{
    "status": "ok",
    "errors": {
        "2133581111": "already owned",
        "7203791111": "already owned"
    },
    "success": {
        "7203791112": "yes"
    },
    "cart_order": "232851"
}
```

{% endtab %}

{% tab title="Invalid" %}

```php
{
    "status": "error",
    "error": "no dids set",
    "verbose": "none",
    "code": "no_dids"
} 
{
    "status": "error",
    "error": "no dids set",
    "verbose": "none",
    "code": "no_dids"
} 
{
    'status' => 'error',
		'code' => 'no_numbers',
    'error' => 'No numbers found in dids'
}
{
    'status' => 'error',
    'code' => 'no_dids',
    'message' => 'Dids are required'
}
{
    'status' => 'error',
		'code' => 'invalid_json',
		'message' => 'Json in dids is invalid'
}
```

{% endtab %}
{% endtabs %}