# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.api19.com/numbers-ordering/vanity-tollfree-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.