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 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

Argument	Required	Type
search	yes	string
qty	no	1 - 10

Curl Post

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

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"
} 

Possible other errors:

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