Phone Validation
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 request
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Query Parameters
query*string
The phone number to validate in E.164 format (must start with +, e.g. +33612345678).
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://api.veille.io/v1/intelligence/phone?query=string"{
"is_valid": true,
"e164_format": "+33612345678",
"country_code": "33",
"country": "FR",
"country_name": "France",
"number_type": "mobile",
"line_type": "mobile",
"carrier": "Orange",
"carrier_type": "mno",
"risk_score": 0,
"is_disposable": false,
"is_virtual": false,
"is_threat": false,
"is_spam": false,
"source_count": 0,
"timezones": [
"Europe/Paris"
],
"location": "France",
"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"
}