Veille

Phone Validation

GET
/v1/intelligence/phone

Validate any phone number in E.164 format. Detects disposable and virtual numbers, identifies carrier and line type (mobile/fixed/VoIP), returns country and timezone, and computes a 0-100 risk score.

Status: Experimental

Credit cost: 1 credit per call

Autorización

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Parámetros de consulta

query*string

The phone number to validate in E.164 format (must start with +, e.g. +33612345678).

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/intelligence/phone?query=string"

{  "carrier": "Orange",  "country": "FR",  "is_spam": false,  "is_valid": true,  "location": "France",  "is_threat": false,  "line_type": "mobile",  "timezones": [    "Europe/Paris"  ],  "is_virtual": false,  "risk_score": 0,  "e164_format": "+33612345678",  "number_type": "mobile",  "carrier_type": "mno",  "country_code": "33",  "country_name": "France",  "source_count": 0,  "is_disposable": false,  "national_format": "06 12 34 56 78",  "international_format": "+33 6 12 34 56 78"}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}