// phone finder
Find a business contact’s phone number
Look a person up by email, LinkedIn profile or company domain. Tomba returns the numbers it holds, with the line type, carrier and country.
// 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 · in the app
Phone Finder in the Tomba app
Search by email, LinkedIn profile or domain in the web app: the numbers Tomba holds, with their line type and carrier.
// also in
- REST APIJSON over HTTPS, 13 SDKs, signed webhooks.
- Bulk CSVUpload a list in the app or POST it to /bulk; download when it's done.
- Google Sheets and ExcelFormulas and a sidebar that call the same endpoints.
- Browser extensionPhone numbers for the person whose profile or page you are on.
- Mobile appPhone numbers from your phone: search by email, LinkedIn profile or domain, on the same credits.
- MCP for AI agentsRemote MCP server, 28 tools, OAuth sign-in.
// 02 · the api
Phone Finder 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-finderemailrichard@piedpiper.com- Work email
domainpiedpiper.com- Company domain: 1 search credit instead of 5
linkedinhttps://www.linkedin.com/in/richard-hendricks- LinkedIn profile URL
requiredone of email, domain, linkedin
// cost
Rate limits by plan5search credits
Charged when: A valid number is returned; 1 search credit instead of 5 when you search by domain.
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
{
"email": "richard@piedpiper.com",
"data": {
"email": "richard@piedpiper.com",
"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-finderdataobject | array- The number; an array with full=true, and an empty array when none is found
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
// 03 · 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
// 04 · capabilities
A number you can call
Each number comes with what you need before you dial.
Three ways in
Search by email address, LinkedIn profile URL or company domain.
Line type
Know whether it's a mobile, landline or VoIP number before you call.
Carrier
See the network operator behind the number.
Formats for your dialer
Each number comes in local, international and E.164 formats.
Region and time zone
Call at a sensible hour with the region and time zone the number belongs to.
Bulk lookups
Upload a CSV of emails, domains or LinkedIn URLs to the bulk phone finder.
// 05 · use cases
What teams build with Phone Finder
// start free
Find the numbers behind your list
Phone lookups use search credits: 5 per lookup that returns a valid number, 1 when you search by domain, and nothing when none is found.
The free plan includes 25 search credits every 30 days.