# Vanity Tollfree - Search

## GET or POST Request

{% hint style="info" %}
<https://v1.api19.com/dids/tfvanity/search?key=yourkey​>
{% endhint %}

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

{% hint style="info" %}
Set your timeout for this request higher than normal, the SMS800 database can take 60 seconds to respond
{% endhint %}

**Search**\
Send us search= with your request

**Vanity Requests Allowed**

Here are some example searches, use any area code or combination:

844\*\*\*\*\*\*\*   —  all 844 numbers available\
84433\*\*\*\*\*  —  all 844 numbers starting with 33\
844\*\*\*\*\*22  —  all 844 numbers \
833\*\*\*\*&&& —  all 833 numbers where the last 3 numbers are repeaters\
844\*\*\*help   — all 844 numbers ending in help&#x20;

<table data-header-hidden><thead><tr><th width="185.54541015625"></th><th></th><th></th></tr></thead><tbody><tr><td>Argument</td><td>Required</td><td>Type</td></tr><tr><td>search</td><td>yes</td><td>string</td></tr><tr><td>qty</td><td>no</td><td>1 - 10</td></tr></tbody></table>

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

```php
curl -X POST https://v1.api19.com/dids/tfvanity/search \
  -d 'key=mykey' \
  -d 'search=844*******' \
  -d 'qty=10'
```

{% endtab %}

{% tab title="JSON Success" %}

```json
{
  "status": "ok",
  "data": {
    "numList": [
      "8447530304",
      "8447530305",
      "8447530306",
      "8447530311",
      "8447530313",
      "8447530315",
      "8447530316",
      "8447530317",
      "8447530318",
      "8447530319"
    ]
  }
}
```

{% endtab %}

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

```javascript
{
    "status": "error",
    "error": "no numbers available for search",
    "verbose": "none"
} 

Possible other errors:

No spare numbers meeting your search criteria found.
Cannot find enough spare numbers that meet your search criteria for requested quantity.
```

{% endtab %}
{% endtabs %}