Bulk Phone Validator

The Bulk Phone Validator allows you to upload a list of phone numbers and verify their validity, format, and carrier details — helping you clean your data and improve deliverability.

🔒 Note: Bulk Phone Validator is available on premium plans only.

How to Use Bulk Phone Validator

Go to the Bulks page
Click on Phone Validator
Click + New Bulk and give your task a unique name
Upload your file containing phone numbers

📄 Accepted formats: .CSV or .TXT
📌 Your file should contain one phone number per row, preferably in international format (e.g., +14155552671)

Validation Checks Performed

For each phone number, Tomba provides:

CSV Column	Description
`Input Data`	Your original phone number
`IsValid`	Whether the number is valid and callable
`Phone`	Cleaned phone number
`Phone Local format`	Phone in local/national format
`Phone International format`	Phone in international format
`Phone Line type`	Mobile, landline, VoIP, etc.
`Carrier`	Telecom provider
`Country Code`	ISO country code
`Timezone`	Timezone of the phone number

Download & Understand Results

After processing:

Click Download to export your results in .CSV format
You can choose to:
- Download all results
- Download only valid numbers
- Download only invalid or unknown numbers

Tips for Best Results

✅ Ensure your phone numbers include the country code
✅ One number per row, in a single column
✅ Max file size: 4MB
✅ Max records per bulk: 10,000

Creating a New Bulk Phone Validation

When you click + New Bulk:

List Name

Give your task a unique name (3-201 characters).

List Content

Enter phone numbers one per line in the text area, or upload a .CSV or .TXT file.

Use international format (e.g., +14155552671) for best results
Numbers must be in a single column
Maximum: 10,000 numbers per bulk
File size must not exceed 4MB

CSV Column Mapping

For multi-column CSV files, a preview shows the first 10 rows. Click on the column containing your phone numbers to select it.

Options

Notify me when ready — Toggle to receive an email notification when complete

Viewing Task Results

Click on any task to view its detail page.

Progress Tracking

While processing: progress bar with percentage, live counter, browser tab favicon badge, and desktop notifications (bell icon).

Results Preview

A preview table shows the first rows with: Phone number, Validity status, Line Type, Carrier, Region/Country, and formatted number.

Download Options

Click Download to choose:

Full list — All results
Valid only — Only valid phone numbers
Invalid / Unknown — Only invalid or undetermined numbers

Task Details

Details grid shows: Created and Expiration dates, Processing duration, Total numbers validated, Validation cost in credits.

Task Actions

From the dropdown menu: Rename, Archive (or Restore), Delete.

Managing Your Bulk Tasks

Easily manage your phone validation tasks:

Sort: By task name, status, or creation date
Search: Locate specific tasks by name
Filter: Toggle between All and Archived tasks
Rename: Change task names via the dropdown menu
Archive: Move completed tasks to the archive for a cleaner view
Restore: Bring archived tasks back to the active list
Delete: Remove tasks permanently via the dropdown menu
Pagination: Choose how many tasks to display per page (10, 20, 50, 100, 150, or 200)

Validate Phone Numbers in Excel

Tomba’s Microsoft Excel Add-in allows validation inside spreadsheets:

Open your file in Excel
Go to the Phone Validator tab
Select the column with phone numbers
Click "Validate phone numbers"

A new column will display validation results, status, and formatted output.

Validate Phone Numbers in Google Sheets

Open your Google Sheet
Go to the Phone Validator tab
Select the column with phone numbers
Click "Validate phone numbers"

Results will populate with:

Validity status
Carrier info
Region details
Proper formatting

Validate via API

You can validate phone numbers programmatically with Tomba’s API:

from tomba.client import Client from tomba.services.phone import Phone client = Client().set_key('ta_xxxx').set_secret('ts_xxxx') phone_validator = Phone(client) result = phone_validator.phone_validator('+14155552671')

Official SDKs Available

Tomba offers SDKs for:

Python, PHP, Go, Rust, Ruby, Dart, JavaScript, C#, R, Lua, Elixir, and more.

Task Progress Tracking

While your bulk task is processing:

A progress bar shows the percentage completed
A live counter displays items processed vs total items
Your browser tab updates with the progress percentage in the favicon
Click the bell icon to enable desktop notifications — you'll be notified when your task finishes

Task Statuses

Each bulk task goes through one of the following statuses:

Pending — Task is queued, not yet started
Running — Currently being processed
Completed — Results are ready to download
No Result — Completed but no results were found
Failed — Task terminated with an error
Cancelled — Stopped by user or system
Expired — Data retention period has passed, results are no longer available

Task Details

Each completed task displays:

Created date and expiration date
Processing duration
Total results found
Total items processed
Verification status and cost (if verification was enabled)
Search cost in credits

Credits & Upgrade

Credits are only consumed when you download the results
If you don't have enough credits, an upgrade prompt will appear with a link to upgrade your plan
Team members will see a notice if the team owner needs more credits

Related Resources

Bulk Operations Overview — All bulk tools in one place
Bulk API Reference — API documentation for bulk endpoints
Pricing & Plans — View plans and credit allowances
How Credits Work — Understand credit usage for bulk operations
Phone Validator API — API reference for phone validation
Tomba CLI Documentation — Command-line interface reference