verify_email

Whether an email address is deliverable, checked live against the mailbox: valid, valid-risky, catch-all, invalid or unknown, with the reason. ₹0.25 per check.

What it does

For one address: validity (valid, valid-risky, catch-all, invalid or unknown), validIdentity and validSMTP, the mxDomain that answered, and a reason with a reasonCode when the check failed, in data. Use it on every address before outreach, including the ones find_email and domain_search returned. It does not find addresses and cannot prove a mailbox is read. valid-risky means the mailbox answered but the domain accepts risky mail; catch-all means the domain accepts anything, so the address could not be proven, not that it is good. treatAliasesAsValid accepts alias addresses as valid.

India: works for any domain, including .in domains and Indian webmail.

Inputs

Generated from the contract captured on 2026-11-05.

FieldTypeRequiredDescription
emailstringyese.g. "name@example.com"
treatAliasesAsValidbooleanno

What drives the cost

Nothing: a flat price per completed check, whatever the verdict (catch-all and unknown included). A check the source could not complete is class: "ok_free", ₹0. Usually one to three seconds; a few domains take ten.

Price today

Price today₹0.25 per check (cost_paise: 25) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹0.38 (hold_paise: 38); when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout39 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "verify_email"
Over RESTPOST https://api.parel.si/v1/run with "tool": "verify_email"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"verify_email","input":{"email":"jane@example.com"}}'

What comes back

data with the verdict. A real answer recorded during the live check of 2026-10-28, with the address replaced:

{
  "jobId": "01M6143S439W5VR662362NGDFR",
  "email": "name@zomato.com",
  "validity": "valid-risky",
  "validIdentity": true,
  "validSMTP": null,
  "displayText": "valid-risky",
  "mxDomain": "alt1.aspmx.l.google.com",
  "reason": null,
  "reasonCode": null
}

Notes

  • validity: valid, valid-risky, catch-all, invalid or unknown. catch-all means the domain could not be checked, not that the address is good.
  • Usually one to three seconds; a few domains take ten.
  • A check that could not complete is free; a completed check is charged whatever the verdict.

Siblings

This page as Markdown: /docs/tools/verify_email.md. Something wrong or missing: hello@parel.si.