How does the Bulk Email Verifier API work?

Create a bulk operation by uploading a list of email addresses, then launch the operation. The API verifies all emails asynchronously using multi-layer checks. Use webhooks or polling to monitor progress.

What is the maximum batch size?

You can verify up to 20,000 email addresses per bulk operation. For larger lists, create multiple bulk operations.

What verification checks are performed?

Each email undergoes syntax validation, MX record checks, SMTP verification, disposable detection, catch-all detection, and deliverability scoring.

What is the data-quality guarantee?

If an address Tomba returned as valid hard-bounces, the credit comes back under the data-quality guarantee (verifier result deliverable or finder score of 60 or more, sent within 30 days from a domain with SPF, DKIM and DMARC).

How long does verification take?

De snelheid hangt af van de grootte van de lijst en van hoe snel elke mailserver antwoordt. Vraag de status van de taak op of stel een webhook in om te horen wanneer hij klaar is.

What results are returned?

Each result includes the email, verification status (valid, invalid, accept_all, unknown), confidence score, disposable flag, SMTP provider, and MX records.

How do I download results?

Once processing completes, use the download endpoint to get results as CSV or JSON. Results include all verification data for each email.

Are webhooks supported?

Yes, configure a webhook URL to receive notifications when your bulk verification completes or when errors occur during processing.

How should I treat accept-all results?

Accept-all domains can be valid but riskier. Prioritize higher confidence scores and consider segmented sending strategies for these records.

What is a recommended verification workflow?

Verify lists close to send time, suppress invalid and disposable addresses, and re-verify older lists periodically to maintain deliverability.

// post /v1/bulk/verifier

Bulk Email Verifier API

Clean and score high-volume email lists with one asynchronous verification pipeline built for senders at scale.

Gratis API-sleutel API-naslag

Email addressesTot 20,000 rijen

POST /bulk/verifier

curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
  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": "Email Verifier job",
    "list": "richard@piedpiper.com\njohn@example.com",
    "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/verifier",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Email Verifier job",
      "list": "richard@piedpiper.com\njohn@example.com",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

// 01 · verzoek

Bulk Email Verifier is één HTTPS-verzoek

Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.

type: verifier
list | data | file: Email addresses
launch: true start de taak meteen
webhook_url: Ontvangt een ondertekend event als de taak klaar is
rows: Tot 20,000 per taak

POST /bulk/verifier

curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
  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": "Email Verifier job",
    "list": "richard@piedpiper.com\njohn@example.com",
    "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/verifier",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Email Verifier job",
      "list": "richard@piedpiper.com\njohn@example.com",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

// 02 · antwoord

Wat je terugkrijgt

JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.

GET/email-verifierVeld

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

POST /bulk/verifier

201 Created

{
  "data": {
    "id": 1042
  }
}

Elke rij, zoals GET /email-verifier die teruggeeft

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 · kosten en limieten

Wat een aanroep kost

Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.

// kosten

1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.

Charged once, at the first download; later downloads are free

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)

// faq

Frequently Asked Questions

Nog vragen? Bezoek het helpcentrum

Doe je eerste aanroep binnen een minuut

Gratis account, echte API-sleutel, dezelfde endpoints die Enterprise-klanten gebruiken.

1Maak een gratis account aan25 zoekopdrachten per maand. Geen creditcard.

2Kopieer je sleutel en secretOnder API-sleutels in het dashboard.

3Roep de API aanPlak het verzoek; het antwoord is 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": [] } }

Bulk Email Verifier API

Bulk Email Verifier is één HTTPS-verzoek

Wat je terugkrijgt

Wat een aanroep kost

Gerelateerde endpoints

Frequently Asked Questions

Doe je eerste aanroep binnen een minuut