API referenceVerify
Verify a phone number
Confirms the number is a usable line in that country and returns the line type and the carrier the range is allocated to.
Free for every account, and counts as one check toward usage.
The country is taken from the country field, then from the value itself when it carries a marker, then from the service default.
AuthorizationBearer <token>
API key sent as 'Authorization: Bearer'.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
A phone value to verify.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://example.com/v1/verify/phone" \ -H "Content-Type: application/json" \ -d '{ "value": "+971 50 123 4567" }'{ "country": { "calling_code": "971", "code": "AE", "name": "United Arab Emirates" }, "details": { "areas": [ "string" ], "carrier": { "brand": "du", "mvno_host": "string", "name": "string", "type": "mno" }, "line_type": "mobile", "portable": true, "prefix": "50", "region": "string" }, "formatted": { "international": "+971 50 123 4567", "national": "050 123 4567" }, "input": "string", "normalized": "string", "reason": "empty_input", "type": "phone", "valid": true, "meta": { "credits_used": 0 }}