phone-validate-v1

Validate a single phone number for list cleaning

Returns line type, current carrier, portability, and DNC status. Each non-cached lookup is billed at $0.003 and aggregated monthly.

post/v1/phone/validate

Request

  • Base URL: https://api.tracklysms.com/api
  • URL: https://api.tracklysms.com/api/v1/phone/validate
  • Auth: API key in header X-Api-Key

Request body

forceboolean

When true, bypass the skip-already-validated gate and the 30-day cache — a fresh LRN lookup is made and billed. Default false.

phonestring required

Phone number (E.164 recommended)

Response

Validation result

cachedboolean

Result served from cache

carrierstring

Friendly display name for current carrier

carrier_rawstring

Raw SPID carrier string from the lookup provider

citystring

City

costnumber

USD billed for this lookup (0 if cached)

countrystring

ISO country code

dispositionstring

ok | unreachable | risky | invalid | unknown

line_typestring

mobile | fixed line | voip | other | unknown

on_dncboolean

Present on the DNC list

phonestring

Normalized E.164 number

portedboolean

Number has been ported from original carrier

statestring

State / region

validboolean

Number is valid per carrier network

Changes

No recorded changes to this operation across all 1 revision of this API.