本文へスキップ

// get /v1/email-verifier

メール検証 API

RESTful APIでSMTPチェック、MX検証、キャッチオール検出によりメールの到達可能性をリアルタイム検証。

1 verification credit

// api コンソール

GETapi.tomba.io/v1/email-verifier
例
email.email
richard@piedpiper.com
email.result
deliverable
email.status
valid
email.score
99
email.smtp_provider
Google
email.accept_all
false
email.disposable
false
email.webmail
false
email.greylisted
false

// 01 · リクエスト

Email Verifier は1回の HTTPS リクエストです

キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。

GET/email-verifier
email必須
The address to verify
enrich_mobilefalse
Also return phone numbers
curl -G https://api.tomba.io/v1/email-verifier \
  --data-urlencode "email=richard@piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

// 02 · レスポンス

返される内容

どの言語でも同じ JSON です。Tomba が把握していないフィールドは null となり、推測はしません。

GET/email-verifier
data.email.resultstring
deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring
valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger
Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null
Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null
The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean
The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean
Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean
Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array
Where the address was found
data.phone_data[]array | null
Phone numbers, when you send enrich_mobile
GET /email-verifier
200 OK
{
  "data": {
    "email": {
      "email": "richard@piedpiper.com",
      "result": "deliverable",
      "status": "valid",
      "score": 99,
      "smtp_provider": "Google",
      "mx": {
        "records": [
          "aspmx.l.google.com",
          "alt1.aspmx.l.google.com"
        ]
      },
      "mx_check": true,
      "smtp_server": true,
      "smtp_check": true,
      "accept_all": false,
      "greylisted": false,
      "block": false,
      "gibberish": false,
      "disposable": false,
      "webmail": false,
      "regex": true,
      "whois": {
        "registrar_name": null,
        "referral_url": null,
        "created_date": null
      }
    },
    "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": null
  }
}

// 03 · 料金と制限

呼び出しの料金

呼び出しは以下の条件の場合にのみ課金されます。レート制限はプランによって異なります。

// 料金

1verification credit

課金条件: The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.

エラー、429 と 451 のレスポンス、利用期間内の同一リクエストの再送は無料です。

クレジットの仕組み

// レート制限

リクエスト数(秒/分/日)
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 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. レート制限

// faq

メール検証 API に関する質問

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

// 無料で始める

どの企業でも、Tomba が見つける人を確認

企業のドメインを入力すると、そこで働く人、その役職、検証済みの勤務先メールアドレスが、それぞれ見つかったページとともに表示されます。無料アカウント、カード不要です。