Verifier

Download schema

Validate email deliverability and mailbox status

Email Verifier

GET

https://api.tomba.io/v1

/email-verifier

Email Verifier verify the deliverability of an email address.

Email Verifier › query Parameters

email

string · required

The email address you want to verify.

enrich_mobile

boolean

Set to true to get the phone number associated with the email address found.

webhook_url

string

Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body.

Email Verifier › Headers

X-Tomba-Key

string · required

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Email Verifier › Responses

Email verification completed successfully

EmailVerifier

object

GET/email-verifier

curl --request GET \
  --url 'https://api.tomba.io/v1/email-verifier?email=m%40wordpress.org' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx'

shell

Example Responses

{
  "data": {
    "email": {
      "email": "email",
      "result": "result",
      "status": "status",
      "score": 0,
      "smtp_provider": "smtp_provider",
      "mx": {
        "records": [
          "string"
        ]
      },
      "mx_check": true,
      "smtp_server": true,
      "smtp_check": true,
      "accept_all": true,
      "greylisted": true,
      "block": true,
      "gibberish": true,
      "disposable": true,
      "webmail": true,
      "regex": true,
      "whois": {
        "registrar_name": "registrar_name",
        "referral_url": "referral_url",
        "created_date": "created_date"
      }
    },
    "sources": [
      {
        "uri": "uri",
        "website_url": "website_url",
        "extracted_on": "extracted_on",
        "last_seen_on": "last_seen_on",
        "still_on_page": true
      }
    ]
  }
}

json

application/json

Finder Phone

Email Verifier

GET

https://api.tomba.io/v1

/email-verifier

Email Verifier verify the deliverability of an email address.

Email Verifier › query Parameters

email

string · required

The email address you want to verify.

enrich_mobile

boolean

Set to true to get the phone number associated with the email address found.

webhook_url

string

Optional webhook URL to receive results asynchronously. If not provided, results will be returned in the response body.

Email Verifier › Headers

X-Tomba-Key

string · required

API key used to authenticate requests. Send this value in the X-Tomba-Key header.

X-Tomba-Secret

string · required

API secret used with X-Tomba-Key to authenticate requests. Send this value in the X-Tomba-Secret header.

Email Verifier › Responses

Email verification completed successfully

EmailVerifier

object