curl -X POST https://api.tracklysms.com/api/v1/phone/validate \
  -H "X-Api-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+14155551234"}'

import requests

response = requests.post(
    "https://api.tracklysms.com/api/v1/phone/validate",
    headers={
        "X-Api-Key": "your_api_key",
        "Content-Type": "application/json",
    },
    json={"phone": "+14155551234"},
)

result = response.json()
if result["disposition"] != "ok":
    print(f"Skip: {result['disposition']} ({result['line_type']})")

const axios = require('axios');

const { data } = await axios.post(
  'https://api.tracklysms.com/api/v1/phone/validate',
  { phone: '+14155551234' },
  {
    headers: {
      'X-Api-Key': 'your_api_key',
      'Content-Type': 'application/json',
    },
  }
);

if (data.disposition !== 'ok') {
  console.log(`Skip: ${data.disposition} (${data.line_type})`);
}

{
  "phone": "+14155551234",
  "valid": true,
  "line_type": "mobile",
  "carrier": "Verizon Wireless",
  "carrier_raw": "CELLCO PARTNERSHIP DBA VERIZON",
  "ported": false,
  "country": "US",
  "state": "California",
  "city": "San Francisco",
  "on_dnc": false,
  "disposition": "ok",
  "cost": 0.003,
  "cached": false
}

{
  "phone": "+13103059808",
  "valid": true,
  "line_type": "landline",
  "carrier": "Frontier",
  "carrier_raw": "FRONTIER CALIFORNIA, INC.",
  "ported": true,
  "country": "US",
  "state": "California",
  "city": "Santa Monica",
  "on_dnc": false,
  "disposition": "unreachable",
  "cost": 0.003,
  "cached": false
}

{
  "error": "validation_error",
  "code": "invalid_phone",
  "message": "phone must be E.164 format for list cleaning"
}

{
  "error": "billing_not_enabled",
  "code": "no_payment_method",
  "message": "An active payment method is required to use phone validation."
}

{
  "error": "provider_unavailable",
  "code": "provider_error",
  "message": "Phone validation service is temporarily unavailable."
}