Skip to content

// bulk operations

Bulk Phone Validator

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

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
  1. 01pendingPOST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } }
  2. 02runninglaunch: trueprogress polled with GET /v1/bulk/phone-validator/1042/progress
  3. 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.

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"}'
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

// start free

See who Tomba finds at any company

Type a company's domain to see its people, their roles and verified work emails, each with the pages it was found on. Free account, no card.