Skip to content

// phone validator

Check a phone number before you call

Send a number. Tomba tells you if it's valid, its line type and carrier, and returns it in the formats your dialer and CRM expect.

// api console

GETapi.tomba.io/v1/phone-validator
Example
valid
true
intl_format
+1 650-555-0132
line_type
MOBILE
carrier
AT&T
country_code
US
region.name
California
timezones
1 item

// teams at these companies use tomba

// 01 · the api

Phone Validator is one HTTPS request

Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.

GET/phone-validator
phonerequired
The number, ideally in E.164
country_codeUS
Country, when the number has no prefix

1search credit

Charged when: Every successful response, including one with no data.

Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.

13 official SDKs: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby, Rust. Libraries in the docs

GET /phone-validator
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"
    ]
  }
}

// 02 · customers

What customers say

  • I've tested over a dozen email and mobile data providers, and Tomba.io stands out as the best. The email finder is consistently accurate, but the mobile phone finder is on another level.
    Al AminFounder & CEO, Biznift
  • Tomba.io keeps getting better every day. I've been using it since 2021, and the progress has been impressive. It's now a leading solution for email finding, verification, and easily finding mobile numbers.
    Osama AhmedSEO Ninja, BYTEBEX

// 03 · capabilities

Everything a number tells you

One call checks the number and formats it.

  • Valid or not

    Checks the number against its country's numbering plan.

  • Line type

    Mobile, landline or VoIP, before you send a text or dial.

  • Carrier

    The network operator behind the number.

  • Every format

    Local, international and E.164, ready for your CRM or dialer.

  • Region and time zone

    Where the number is registered and when to call.

  • Bulk validation

    Upload a CSV of numbers to the bulk phone validator.

// 05 · questions

Phone Validator: quick answers

Still have questions? Visit the help center

// start free

Check numbers before you dial

Each validation uses 1 search credit and returns the line type, the carrier and every format your dialer needs.

The free plan includes 25 search credits every 30 days.