一括電話番号検証とは？

一括電話番号検証は、大量の電話番号の有効性とステータスを検証できるサービスです。電話番号のCSVファイルをアップロードすると、フォーマット検証、キャリア検出、回線タイプ識別を含む詳細な検証結果を受け取れます。

電話番号にはどのようなチェックが行われますか？

当社の電話番号検証は、フォーマット検証、キャリア検索、回線タイプ検出（携帯電話、固定電話、VoIP）、到達可能性ステータスを含む複数のチェックを実行します。これにより、連絡先リストをクリーニングし、接続率を向上させることができます。

一括電話番号検証は無料で使えますか？

一括電話番号検証には無料アカウントが必要です。必要な検証数に応じて適切なプランを選択できます。アカウントをアップグレードする前に一括電話番号検証をお試しいただけます。CSVをアップロードして検証結果をプレビューできます。サブスクリプションはいつでもキャンセルできます。

何カ国がサポートされていますか？

200カ国以上です。番号はE.164国際フォーマットに正規化され、サポートされているすべての地域について、キャリア名、回線タイプ、タイムゾーン、到達可能性シグナルでエンリッチメントされます。

検証ツールはどのようなステータスを返しますか？

Valid、Invalid、Risky、Unknownです。各行には回線タイプ（携帯電話、固定電話、VoIP、フリーダイヤル）、キャリア検索、信頼スコアも含まれるため、発信前にしきい値を設定できます。

どのファイル形式と制限が適用されますか？

1行につき1つの電話番号（できれば国際フォーマット）を含むCSVまたはTXTをアップロードしてください。1バッチあたり最大10,000件の電話番号に対応しています。CSV、XLSX、JSONとしてエクスポートできます。

リストは自動的に重複除外されますか？

はい。完全な重複はアップロード時に統合されるため、一意の番号ごとに1回のみ課金され、エクスポートでは元の行の順序が保持されます。

// 一括操作

一括電話番号検証

電話番号のCSVをアップロードして、フォーマットと配信可能性をすべて一度に検証します。

一括処理を開始 APIを見る

Phone numbers, with an optional country1ジョブ最大 10,000 行CSV、リスト、または行

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

一括Phone Validator · /bulk/phone-validator2,500 / 2,500

01pendingPOST /v1/bulk/phone-validator201 · { "data": { "id": 1042 } }
02runninglaunch: trueGET /v1/bulk/phone-validator/1042/progress で進捗をポーリング
03completedbulk.completedwebhook_url に署名付き Webhook を配信

GET /v1/bulk/phone-validator/1042/download?file=full初回ダウンロード時に課金 · ジョブは180日後に期限切れ

// 01 · 入力

一括 Phone Validator ジョブの入力

アプリで最大4 MBの CSV をアップロードするか、リスト、行、またはファイルを POST /v1/bulk/phone-validator に送信します。列はヘッダー行から自動判別されます。フィールドインデックスを指定して自分で選ぶこともできます。

POST/bulk/phone-validator列

phone_field_index, country_field_index: Phone number, country

// 02 · api

1回のリクエストでジョブを開始

1回の呼び出しで作成と開始を行い、進捗を確認するか、署名付きの bulk.completed イベントを受け取ります。結果の各行は GET /phone-validator が返す内容と同じです。

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

各行は 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"
    ]
  }
}

// 03 · 料金と制限

ジョブの料金

ジョブの作成や開始には料金はかかりません。料金は結果を初めてダウンロードしたときに1回だけ請求されます。

// 行ごとの課金

1 search credit per valid number.

ドキュメントの一括処理の課金

行数：1ジョブあたり最大 10,000 行
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 · どこでも利用可能

Phone Validator ジョブをアプリまたはコードから実行

同じジョブ、同じクレジット：アプリでファイルをアップロードするか、API を呼び出すか、スプレッドシートやノーコードツールから実行できます。

リクエストの完全なリファレンス： /api/bulk/phone-validator

// お客様

Phone Validator ジョブを実行しているチーム

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

よくある質問

ほかにご質問がありますか？ヘルプセンターを見る

1分で最初の呼び出しを

無料アカウント、本物の API キー、Enterprise のお客様と同じエンドポイント。

1無料アカウントを作成月25回の検索。カード不要。

2キーとシークレットをコピーダッシュボードの「API キー」から。

3API を呼び出すリクエストを貼り付けると、JSON で応答が返ります。

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": [] } }