Skip to main content

Phone Validator

The Phone Validator helps you check if a phone number is valid, reachable, and correctly formatted

Tomba.io Team avatar
Written by Tomba.io Team
Updated this week

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:

  1. Format Check – Verifies if the phone number follows international standards (E.164).

  2. Carrier Lookup – Identifies the network provider.

  3. Line Type Detection – Tells you if it’s a mobile, landline, VoIP, or toll-free number.

  4. Reachability Test – Confirms if the number is active and can receive calls.

  5. 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

Content-Type

application/json

X-Tomba-Key

your_api_key

X-Tomba-Secret

your_secret_key

πŸ“₯ Query Parameters

Parameter

Type

Required

Description

phone

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

email

Related email if found

domain

Related domain if found

valid

Whether the phone number is valid

local_format

Phone number in local format

intl_format

Phone number in international format

e164_format

Phone number in E.164 format

rfc3966_format

Phone number in RFC3966 format

country_code

The ISO country code of the number

line_type

Type of line (e.g. mobile, landline, toll free)

carrier

Carrier information if available

timezones

Timezones where this phone number is located


Need Help?

Got questions? Contact our support team we’re here to help!

Did this answer your question?