// phone validator
Check a phone number before you call
Send a number. Tomba tells you if it's valid, its line type and carrier, and returns it in the formats your dialer and CRM expect.
// api console
- valid
- true
- intl_format
- +1 650-555-0132
- line_type
- MOBILE
- carrier
- AT&T
- country_code
- US
- region.name
- California
- timezones
- 1 item
// teams at these companies use tomba
// 01 · the api
Phone Validator is one HTTPS request
Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.
/phone-validatorphonerequired- The number, ideally in E.164
country_codeUS- Country, when the number has no prefix
// cost
Rate limits by plan1search credit
Charged when: Every successful response, including one with no data.
Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.
13 official SDKs: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby, Rust. Libraries in the docs
{
"data": {
"valid": true,
"local_format": "(650) 555-0132",
"intl_format": "+1 650-555-0132",
"e164_format": "+16505550132",
"rfc3966_format": "tel:+1-650-555-0132",
"country_code": "US",
"line_type": "MOBILE",
"carrier": "AT&T",
"region": {
"name": "California",
"code": "CA"
},
"timezones": [
"America/Los_Angeles"
]
}
}/phone-validatordataobject | array- The number's details; an empty array, with phone repeating your input, when it isn't valid
data.validboolean | null- Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null- The number in international, E.164 and national formats
data.country_codestring | null- Country of the number (ISO code)
data.line_typestring | null- MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null- The network operator
data.region, data.timezonesobject | null, array | null- Where the number is registered, and its time zones
// 02 · customers
What customers say
I've tested over a dozen email and mobile data providers, and Tomba.io stands out as the best. The email finder is consistently accurate, but the mobile phone finder is on another level.
Al AminFounder & CEO, BizniftTomba.io keeps getting better every day. I've been using it since 2021, and the progress has been impressive. It's now a leading solution for email finding, verification, and easily finding mobile numbers.
Osama AhmedSEO Ninja, BYTEBEX
// 03 · capabilities
Everything a number tells you
One call checks the number and formats it.
Valid or not
Checks the number against its country's numbering plan.
Line type
Mobile, landline or VoIP, before you send a text or dial.
Carrier
The network operator behind the number.
Every format
Local, international and E.164, ready for your CRM or dialer.
Region and time zone
Where the number is registered and when to call.
Bulk validation
Upload a CSV of numbers to the bulk phone validator.
// 04 · use cases
What teams build with Phone Validator
// start free
Check numbers before you dial
Each validation uses 1 search credit and returns the line type, the carrier and every format your dialer needs.
The free plan includes 25 search credits every 30 days.