TombaTomba
Start free
  • Documentation
  • API reference
  • SDKs & CLI
  • AI & MCP
  • Integrations
  • Enterprise
  • Migration guides

Find, verify and enrich B2B contacts from public sources, in the app, your spreadsheet or through the API.

GDPR & CCPA

// docs

  • API changelog
  • Support options
  • Security

// platform

  • Dashboard
  • Pricing
  • API status

// resources

  • Help center
  • Product updates
  • TombaBot crawler

// company

  • Website
  • Contact us
  • Edit or remove your data

© 2021–2026 Tomba.io

  • Terms of service
  • Privacy policy
  • Cookie policy
  • Security policy
  • GDPR
  • CCPA
Clearbit
Email verifiers
    OverviewNeverBounceMillionVerifierBounceBanBouncerKickboxHunterZeroBounceEmailableClearoutDeBounce
Email finders
Phone finders
Email verifiers

Migrate from Hunter (email verifier)

This guide maps the Hunter API v2 Email Verifier and Account endpoints to the Tomba Email Verifier. Hunter's Domain Search, Email Finder, and enrichment endpoints are covered in Migrate from Hunter (email finder). Hunter API behavior checked on 2026-09-29 against the Hunter API v2 reference.

Before you begin

  • Get your API key (ta_…) and secret (ts_…); see Authentication.
  • Check what a verification costs in Credit costs and your plan's throttling in Limits by plan.
  • Set your HTTP client timeout to at least 180 seconds. Tomba returns the finished result in the response.

Endpoint mapping

Replace the base URL https://api.hunter.io/v2 with https://api.tomba.io/v1.

HunterTombaNotes
GET /email-verifierGET /v1/email-verifier
GET /accountGET /v1/meSee Check usage.

Authentication changes

Hunter accepts the key as the api_key parameter, the X-API-KEY header, or a bearer token. Tomba needs two headers, X-Tomba-Key and X-Tomba-Secret, and doesn't accept credentials in the query string:

TerminalCode
# Hunter curl "https://api.hunter.io/v2/email-verifier?email=jane.doe@stripe.com" \ -H "X-API-KEY: $HUNTER_API_KEY" # Tomba curl "https://api.tomba.io/v1/email-verifier?email=jane.doe@stripe.com" \ -H "X-Tomba-Key: $TOMBA_API_KEY" \ -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

Tomba API keys expire; plan their rotation with Key expiry.

Parameter mapping

HunterTombaNotes
emailemailRequired. A malformed address returns 422 params_invalid instead of a result.

Response field mapping

Tomba nests the checks in data.email and returns the sources in data.sources. Field definitions are in Email verifier response.

HunterTombaNotes
data.statusdata.email.statusSee Status mapping.
data.resultdata.email.result
data.scoredata.email.scoreComputed differently.
data.emaildata.email.emailAn empty string when the domain is disposable.
data.regexpdata.email.regex
data.gibberish, disposable, webmail, accept_all, blockdata.email.gibberish, .disposable, .webmail, .accept_all, .block
data.mx_recordsdata.email.mx_checkTomba's data.email.mx.records lists the MX hosts.
data.smtp_checkdata.email.status is validTomba's smtp_check field only mirrors mx_check. Don't read it as a mailbox result.
data.smtp_serverNo equivalentTomba's smtp_server also mirrors mx_check.
data.verificationNo equivalent
data.sources[]data.sources[]domain is website_url.

Status mapping

Hunter statusTomba statusTomba result
validvaliddeliverable
invalidinvalidundeliverable
accept_allaccept_allrisky
webmailThe mailbox result, with webmail: trueDepends on the status
disposabledisposableEmpty string
unknownunknownrisky

Tomba has no webmail status: it checks webmail addresses like any other and sets the webmail field. Compare status case-insensitively. Each value is defined in Status values.

Error mapping

Hunter returns errors as an array of {id, code, details}. Tomba returns a single errors object with type, message, and code. The meaning of 403 and 429 also changes:

HunterTombaWhat to do
400 wrong_params or another invalid_* id422 params_invalidFix the parameter named in the message.
401 no valid API key400 authentication_failed (missing or malformed), 400 api_key_expired, 401 authentication_failed (wrong key or secret)Check both headers; rotate an expired key.
403 rate limit reached429 rate_limitRetry after the Retry-After delay; see Handle 429 responses.
429 usage limit reached402 quota_exceededWait for your usage window to renew or add credits.
429 restricted_account401 authentication_failedContact support.
451 claimed_email451 claimed_emailSame meaning. Remove the address from your data.
202 verification in progressNot returnedRemove the polling loop.
222 SMTP server error408 proxy_errorRetry later.
5xx500 api_errorRetry with backoff.

Error responses don't consume credits. Every type is listed in Errors.

Bulk and async jobs

Hunter runs bulk Email Verifier lists from its dashboard, and its API endpoint takes one address per request. Tomba runs lists through the API as verifier bulk jobs: send a JSON list of addresses or a CSV file. See Email verifier.

Each job is created, launched, polled, and downloaded as CSV; see Lifecycle. A job is charged when you first download its results; see Billing.

Tomba's single-request endpoint never returns 202, so remove the retry loop you use for Hunter's Email Verifier.

Code example

This function replaces a call to Hunter's Email Verifier and returns Hunter's field names. It needs Node.js 18 or later.

Code
const TOMBA_HEADERS = { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY, }; async function emailVerifier(email) { const url = new URL("https://api.tomba.io/v1/email-verifier"); url.searchParams.set("email", email); const res = await fetch(url, { headers: TOMBA_HEADERS }); const body = await res.json(); if (body.errors) { throw new Error( `${res.status} ${body.errors.type}: ${body.errors.message}`, ); } const check = body.data.email; const status = check.status.toLowerCase(); return { status, result: check.result, score: check.score, email: check.email, regexp: check.regex, gibberish: check.gibberish, disposable: check.disposable, webmail: check.webmail, mx_records: check.mx_check, smtp_check: status === "valid", accept_all: check.accept_all, block: check.block, sources: (body.data.sources ?? []).map( ({ website_url, ...source }) => ({ domain: website_url, ...source, }), ), }; } console.log(await emailVerifier("jane.doe@stripe.com"));

Cutover checklist

  1. Store the Tomba key and secret as TOMBA_API_KEY and TOMBA_SECRET_KEY, and send them as X-Tomba-Key and X-Tomba-Secret instead of api_key, X-API-KEY, or a bearer token.
  2. Change the base URL and read the verifier fields under data.email.
  3. Handle webmail addresses through the webmail field, compare status case-insensitively, and stop reading smtp_check as a mailbox result.
  4. Swap error handling: 402 replaces Hunter's 429, 429 replaces Hunter's 403, 408 replaces 222, and errors is an object, not an array.
  5. Remove the 202 polling loop.
  6. Move list processing to verifier bulk jobs.
  7. Verify the same sample of addresses with both services and compare the results before you switch production traffic.
Last modified on November 6, 2026
KickboxZeroBounce
On this page
  • Before you begin
  • Endpoint mapping
  • Authentication changes
  • Parameter mapping
  • Response field mapping
  • Status mapping
  • Error mapping
  • Bulk and async jobs
  • Code example
  • Cutover checklist
Javascript