The Phone Validator helps you check if a phone number is valid, reachable, and correctly formatted saving you time and ensuring cleaner outreach data.
Whether you're verifying numbers one-by-one or in bulk, Tomba delivers real-time validation.
π How It Works
Tomba runs a series of checks to ensure the accuracy and reliability of each phone number you input:
Format Check β Verifies if the phone number follows international standards (E.164).
Carrier Lookup β Identifies the network provider.
Line Type Detection β Tells you if itβs a mobile, landline, VoIP, or toll-free number.
Reachability Test β Confirms if the number is active and can receive calls.
Country Detection β Detects the country and region based on the phone prefix.
What Youβll Get
Each phone number validated will return:
Country & region
Carrier (e.g., AT&T, Orange)
Line type (mobile, landline, VoIP, etc.)
Validity status
Reachability status
Phone Validator API
The Phone Validator API helps you check if a phone number is valid, reachable, and correctly formatted saving you time and ensuring cleaner outreach data.
π Endpoint
GET https://api.tomba.io/v1/phone-validator
π§Ύ Headers
Header | Value |
|
|
| your_api_key |
| your_secret_key |
π₯ Query Parameters
Parameter | Type | Required | Description |
| string | required | The phone number to validate |
π¦ Example Request
curl --request GET \
--url "https://api.tomba.io/v1/phone-validator?phone=+18773818743" \
--header 'Content-Type: application/json' \
-H "X-Tomba-Key: your_api_key" \
-H "X-Tomba-Secret: your_secret_key"
π Example Response
{
"data": {
"email": "email",
"domain": "domain",
"valid": true,
"local_format": "local_format",
"intl_format": "intl_format",
"e164_format": "e164_format",
"rfc3966_format": "rfc3966_format",
"country_code": "country_code",
"line_type": "line_type",
"carrier": {},
"timezones": "timezones"
}
}
π Field Explanation
Field | Description |
| Related email if found |
| Related domain if found |
| Whether the phone number is valid |
| Phone number in local format |
| Phone number in international format |
| Phone number in E.164 format |
| Phone number in RFC3966 format |
| The ISO country code of the number |
| Type of line (e.g. mobile, landline, toll free) |
| Carrier information if available |
| Timezones where this phone number is located |
Need Help?
Got questions? Contact our support team weβre here to help!