Back to APIs

Unified Agent API

Phone Validation

Phone Validation

Check a phone number before you dial: valid or not, mobile, landline or VoIP, its carrier, and whether the handset is reachable.

POST/v1/phones/verify

Overview

Check whether a phone number is valid and in service, its line type and carrier

Credits

3 credits per call

Providers

Twilio

SDK Method

client.verify_phone(...)

Parameters

numberRequired

string

Phone number, in international form (+ and country code) or national with country.

country

string

ISO 3166 two-letter country code of a national number.

Example Response

{
  "success": true,
  "data": {
    "number": "+31612345678",
    "national_format": "06 12345678",
    "country": "NL",
    "status": "valid",
    "sub_status": "",
    "line_type": "mobile",
    "mobile": true,
    "voip": false,
    "carrier": "KPN",
    "mobile_country_code": "204",
    "mobile_network_code": "08",
    "line_status": "reachable",
    "reachable": true
  },
  "metadata": {
    "provider_used": "twilio",
    "providers_tried": [
      "twilio"
    ],
    "mode_used": null,
    "response_time_ms": 612,
    "request_id": "req_3f9a1c27"
  },
  "credits_used": 3
}

Get Started

Create a Suprsonic API key in your dashboard, then call the endpoint with your key in the Authorization header.

Try Phone Validation

Test Phone Validation in the interactive playground. No setup required.

Open Playground