Utilities ยท sync
phone-truth
Phone number validate, normalize, classify. libphonenumber, served.
Verdict + classification
About
phone-truth wraps libphonenumber-js โ the JavaScript port of Google's reference phone-number library. Same library used internally by Twilio, WhatsApp, and most messaging platforms; we expose it as a one-call API.
Returns: โข `valid` (passes country-specific validation) + `possible` (looks plausibly like a phone number) โข `country` (ISO 3166-1) + `countryCallingCode` โข Formatted views: `national`, `international`, `e164`, `rfc3966`, `uri` โข Line-type classification: `mobile`, `fixed_line`, `fixed_line_or_mobile`, `toll_free`, `premium_rate`, `voip`, `personal_number`, etc. โข Convenience booleans: `isMobile`, `isFixed`, `isTollFree`, `isPremium`, `isVoip`
Use `defaultCountry` (2-letter ISO code) when the input lacks a `+countryCode` prefix โ parser uses it to disambiguate.
Competes with: Twilio Lookup ($0.005), Numverify (APILayer). Carrier-name lookup needs a paid HLR provider โ we deliberately skip it for v1; everything else is offline-fast.
{
"type": "object",
"required": [
"phone"
],
"properties": {
"phone": {
"type": "string",
"maxLength": 60
},
"defaultCountry": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166-1 2-letter code."
}
}
}These are descriptive previews. Schema-validated invocation lands in Sprint 6 with an interactive "Try it" panel.
Reviews (0)
No reviews yet โ be the first to share your experience.