What is Bulk Phone Validation?

Bulk Phone Validation is a service that allows you to verify the validity and status of phone numbers in large quantities. Upload a CSV file with phone numbers and receive detailed validation results including format verification, carrier detection, and line type identification.

What checks are performed on phone numbers?

Our phone validation performs multiple checks including format validation, carrier lookup, line type detection (mobile, landline, VoIP), and reachability status. This helps you clean your contact lists and improve connection rates.

Is the Bulk Phone Validator free to use?

The Bulk Phone Validator requires a Free account. You can choose the right plan for you, depending on the number of validations you need. You can try out the Bulk Phone Validator before upgrading your account. Upload your CSV to preview the validation results. You can cancel your subscription at any time.

// bulk operations

Bulk Phone Validator

Upload a CSV of phone numbers and validate them all for format and deliverability at once.

Start Bulk Processing View API

Phone numbers, with an optional countryUp to 10,000 rows a jobCSV, list or rows

phone-validator-list.csv2,500 rows · phone numbers, with an optional countrycompleted

Bulk Phone Validator · /bulk/phone-validator2,500 / 2,500

01pendingPOST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } }
02runninglaunch: trueprogress polled with GET /v1/bulk/phone-validator/1042/progress
03completedbulk.completedsigned webhook delivered to your webhook_url

GET /v1/bulk/phone-validator/1042/download?file=fullCharged at the first download · the job expires after 180 days

// 01 · input

The input of a bulk Phone Validator job

Upload a CSV of up to 4 MB in the app, or send a list, rows or a file to POST /v1/bulk/phone-validator. Columns are found from the header row; set a field index to choose one yourself.

POST/bulk/phone-validatorColumns

phone_field_index, country_field_index: Phone number, country

// 02 · api

One request starts the job

Create and launch it in one call, then follow its progress or receive a signed bulk.completed event. Each result row is what GET /phone-validator returns.

POST /bulk/phone-validator

curl -X POST "https://api.tomba.io/v1/bulk/phone-validator" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Phone Validator job","list":"+16505550132","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

const res = await fetch("https://api.tomba.io/v1/bulk/phone-validator", {
  method: "POST",
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "Phone Validator job",
    "list": "+16505550132",
    "launch": true,
    "webhook_url": "https://hooks.example.com/tomba"
  })
});
const { data } = await res.json(); // { id }

import os, requests

res = requests.post(
    "https://api.tomba.io/v1/bulk/phone-validator",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Phone Validator job",
      "list": "+16505550132",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

POST /bulk/phone-validator

201 Created

{
  "data": {
    "id": 1042
  }
}

Each row, as GET /phone-validator returns it

200 OK

{
  "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"
    ]
  }
}

// 03 · cost and limits

What a job costs

Nothing is charged to create or launch a job. Its cost is charged once, at the first download of its results.

// billing per row

1 search credit per valid number.

Bulk billing in the docs

Rows: up to 10,000 per job
Jobs created: 15 per day for each type
Running jobs: 2 per type
Downloads: 25 per day for each job
Request size: 4 MB (CSV, list or rows)

// 04 · use it anywhere

Run Phone Validator jobs from the app or your code

The same job, the same credits: upload a file in the app, call the API, or work from a spreadsheet or a no-code tool.

The full request reference: /api/bulk/phone-validator

// customers

Teams that run Phone Validator jobs

Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.io
The data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation

// faq

Frequently Asked Questions

Still have questions? Visit the help center

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY } }); const { data } = await res.json();

import os, requests res = requests.get( "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", headers={ "X-Tomba-Key": os.environ["TOMBA_API_KEY"], "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"], }, ) data = res.json()["data"]

{ "data": { "email": "richard@piedpiper.com", "first_name": "Richard", "last_name": "Hendricks", "full_name": "Richard Hendricks", "website_url": "piedpiper.com", "company": "Pied Piper", "pattern": "{first}", "department": "executive", "type": "personal", "position": "CEO", "country": "US", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/richard-hendricks", "score": 100, "accept_all": false, "phone_number": true, "verification": { "date": "2025-01-15T10:32:00+01:00", "status": "valid" }, "sources": [ { "uri": "https://piedpiper.com/blog/engineering", "website_url": "piedpiper.com", "extracted_on": "2024-06-01T09:14:07+01:00", "last_seen_on": "2025-01-10T17:02:44+01:00", "still_on_page": true } ], "phone_data": [] } }