Suprsonic

Phone Validation

Changed on

Check whether a phone number is valid and in service, its line type and carrier. Returns the status (valid when a carrier holds the number, invalid when it is malformed, outside its country's numbering plan, held by no carrier or not in service, unknown when its carrier data is withheld) with a sub-status, the number in international and national form, its country, line type (mobile, landline, fixed_voip, non_fixed_voip, toll_free and others), carrier, the network's line status and whether the handset is reachable now (null where the network does not say). A number its country's numbering plan rules out is answered free. Use before calling or texting a number you were given or found, or to sort a list of numbers into mobiles, landlines and VoIP. To find a person's number use phones. Pass number in international form (+ and its country code), or a national number with country. Cost: 3 credits, charged only when a call succeeds.

post/v1/phones/verify

Request

  • Base URL
    https://suprsonic.ai
  • Auth
    HTTP bearer

Request body

numberstring required
countrystring nullable

Response

The call's envelope: success, data (the capability's result), metadata, and credits_used (0 when the call did not succeed).

successboolean required
credits_usedinteger

Changes