Skip to main content
POST
/
v1
/
tools
/
verify
/
email
Verify Email
curl --request POST \
  --url https://api.example.com/v1/tools/verify/email \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>"
}
'

​
Overview

Verify whether an email address is deliverable. Checks MX records, mailbox existence, and other factors to determine if an email will be successfully delivered.

​
Request Body

​
email
string
required
Email address to verify

​
Response (202 - Processing)

{
  "request_id": "req_abc123",
  "status": "processing",
  "tool": "verify_email",
  "message": "Email verification job queued successfully"
}

​
Job Result

{
  "status": "completed",
  "result": {
    "email": "[email protected]",
    "deliverable": true,
    "reason": "valid_mailbox",
    "provider": "verification_service"
  }
}

​
Possible Reasons

ReasonDescription
valid_mailboxEmail exists and is deliverable
invalid_mailboxMailbox does not exist
invalid_domainDomain has no MX records
catch_allDomain accepts all emails (can’t verify specific address)
disposableTemporary/disposable email address
role_basedRole-based email (info@, support@, etc.)

​
SDK Usage

const result = await agent.verifyEmail({
  email: "[email protected]",
});

if (result.deliverable) {
  console.log("Email is deliverable");
} else {
  console.log(`Not deliverable: ${result.reason}`);
}

​
Example: Verify Before Sending

// Find email first
const found = await agent.findEmail({
  full_name: "John Doe",
  company_domain: "example.com",
});

if (found.found) {
  // Verify before sending
  const verification = await agent.verifyEmail({
    email: found.email,
  });

  if (verification.deliverable) {
    await agent.email({
      to: found.email,
      subject: "Hello",
      body: "Your message here...",
    });
  } else {
    console.log(`Skipping undeliverable email: ${verification.reason}`);
  }
}

​
Best Practices

  1. Always verify before bulk sends - Reduces bounce rates
  2. Handle catch-all domains - These accept all emails but may not deliver
  3. Skip disposable emails - Usually not worth sending to
  4. Consider role-based emails - May go to shared inboxes