// get /v1/phone-validator
電話番号検証 API
RESTful APIで電話番号をリアルタイム検証 フォーマットチェック、タイプ検出、国＆キャリア識別。
1 search credit
// api コンソール
例API リファレンスのレスポンス例
- valid
- true
- intl_format
- +1 650-555-0132
- line_type
- MOBILE
- carrier
- AT&T
- country_code
- US
- region.name
- California
- timezones
- 1 item
// 01 · リクエスト
Phone Validator は1回の HTTPS リクエストです
キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。
GET
/phone-validatorphone必須- The number, ideally in E.164
country_codeUS- Country, when the number has no prefix
curl -G https://api.tomba.io/v1/phone-validator \
--data-urlencode "phone=+16505550132" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const params = new URLSearchParams({
phone: "+16505550132"
});
const res = await fetch(`https://api.tomba.io/v1/phone-validator?${params}`, {
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/phone-validator",
params={
"phone": "+16505550132",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · レスポンス
返される内容
どの言語でも同じ JSON です。Tomba が把握していないフィールドは null となり、推測はしません。
GET
/phone-validatordataobject | array- The number's details; an empty array, with phone repeating your input, when it isn't valid
data.validboolean | null- Whether the number is a valid phone number
data.intl_format, data.e164_format, data.local_formatstring | null- The number in international, E.164 and national formats
data.country_codestring | null- Country of the number (ISO code)
data.line_typestring | null- MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, VOIP, TOLL_FREE…
data.carrierstring | null- The network operator
data.region, data.timezonesobject | null, array | null- Where the number is registered, and its time zones
GET /phone-validator
200 OK· 1 search credit
{
"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 · 料金と制限
呼び出しの料金
呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。
// 料金
1search credit
課金条件: Every successful response, including one with no data.
エラー、429 と 451 のレスポンス、利用期間内の同一リクエストの再送は無料です。
クレジットの仕組み// レート制限
リクエスト数（秒／分／日）| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
横にスクロールするとすべての列を表示できます
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. レート制限
フォーマット検証、番号タイプ検出、国/地域識別、キャリア検索、タイムゾーン検出。
ローカル、国際、E.164、RFC3966フォーマット、加えて国コードと通話コード。
電話番号検証は1クレジット。電話番号検索（10クレジット）よりはるかに安価です。
はい。バルク電話番号検証APIでCSVまたはAPIにより数千件の番号を処理できます。
国内形式、国際形式、E.164、国番号の有無を問わず、どの形式でも使えます。Tomba が形式を自動で判定して正規化します。
はい。検証した各番号のネットワーク事業者・通信事業者名を返します。SMS のルーティングや到達率の予測に役立ちます。
応答時間はエンドポイントや、アドレスの検証の難しさによって異なります。タイムアウトには余裕を持たせ（ドキュメントでは最大180秒を推奨）、大量の処理には一括ジョブや Webhook を使用してください。リアルタイムのフォーム検証やユーザー向けアプリケーションにも適しています。
公式 SDK は13種類：C#、Dart、Deno、Elixir、Go、Lua、Node.js、Perl、PHP、Python、R、Ruby、Rust。