Vanity Tollfree - Search

Search the toll free database for specific vanity numbers

GET or POST Request

https://v1.api19.com/dids/tfvanity/search?key=yourkey​

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

Set your timeout for this request higher than normal, the SMS800 database can take 60 seconds to respond

Search Send us search= with your request

Vanity Requests Allowed

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

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

We give you the City and Ratecenter so you can get human readable data (for instance ratecenter LSAN DA 01 is actually Los Angeles: 01 as the City.

Argument	Required	Type
search	yes	string

Curl Post

curl -X POST https://v1.api19.com/dids/tfvanity/search \
 -d 'search=844*******' 

JSON Success

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

JSON Error Response

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