Validate Phone API

Frequently Asked Questions

• Can I use the Validate Phone API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the Validate Phone API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

• How do I get an API key and start using the Validate Phone API?

  Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

• What happens if I exceed my quota for the month?

  Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.

• What happens if a request to the Validate Phone API fails?

  The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

• Do I need to include the country code in the number parameter?

  If you do not set the optional country parameter (a 2-letter ISO-3166 code), the required number parameter must include its 3-digit country code prefix, for example +12065550100. Browse related verification tools in the API catalog.

• What metadata does the Validate Phone response include?

  The JSON response returns valid (whether the number is valid), type (such as mobile, landline, or toll_free), international_number in normalized E.164 format, country_code (ISO-3166), and carrier when available. Unsuccessful requests instead return one of the documented error codes.

• What are some use cases for the Validate Phone API?

  You can verify phone numbers at signup using the valid field, normalize contact lists into E.164 international_number format, and route messages based on the type and carrier fields. For broader contact verification, pair it with the Validate Email API.

• Can the API tell me whether a number is mobile or landline?

  Yes, the type field distinguishes values like mobile, landline, and toll_free when that information is available for the number. To enrich validation with geolocation data, you can combine it with the IP Lookup API.