Skip to main content
The Email Verification endpoint validates individual email addresses to protect your sender reputation and keep your outreach lists clean. You submit an email with an optional deepVerification flag, and Clodura responds immediately with a result if verification completes quickly (200 OK), or queues an asynchronous job and returns a 202 Accepted when the domain requires deeper analysis — such as catch-all domains or high-security mail servers. Once a queued job finishes, Clodura posts the final verdict to your webhookUrl. Standard verification is fast and suitable for most business email addresses. Deep verification takes longer but is the right choice for validating catch-all domains where a standard check cannot determine true deliverability.
Credit cost:
  • Standard verification: 0.04 credits per request
  • Deep verification: 0.1 credits per request
Plan availability: This endpoint is available on Free Forever, Max, and PAYG plans. If you are on an Enterprise or legacy plan not listed, contact support@clodura.ai to discuss access.

​
Endpoint

POST /api/v1/verify/email

​
Request

​
Headers

HeaderValue
X-API-KEYYour Clodura API key
Content-Typeapplication/json

​
Body Parameters

​
email
string
required
The email address you want to verify (e.g., john@example.com).
​
deepVerification
boolean
When true, Clodura performs deep verification suitable for catch-all domains and high-security mail servers. Costs 0.1 credits. When false (default), standard verification is used at 0.04 credits.
​
webhookUrl
string
The URL where Clodura will POST the final verification result once processing completes. Strongly recommended for deep verification, where results may not be immediate.

​
Example Request

curl --request POST \
  --url https://api.clodura.ai/api/v1/verify/email \
  --header 'X-API-KEY: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "john@example.com",
    "deepVerification": false,
    "webhookUrl": "https://yourdomain.com/webhooks/clodura"
  }'

​
Response

​
200 OK — Synchronous Result

Returned when verification completes immediately. The email’s deliverability verdict is available in the response body.
​
email
string
The email address that was verified.
​
deepVerification
boolean
Indicates whether deep verification was used for this request.
​
trackingId
string
A unique document ID for this verification job. Use this to poll for results or match incoming webhook payloads.
​
verificationProgress
string
Current processing state: In-progress or Completed.
​
verificationStatus
string
The deliverability verdict: Deliverable, Undeliverable, Risky (Catch-all), or Pending.
​
createdAt
string
ISO 8601 timestamp indicating when the verification job was created.
{
  "email": "john@example.com",
  "deepVerification": false,
  "trackingId": "664f1a2b3c4d5e6f7a8b9c0d",
  "verificationProgress": "Completed",
  "verificationStatus": "Deliverable",
  "createdAt": "2024-06-01T10:00:00.000Z"
}

​
202 Accepted — Asynchronous Job Queued

Returned when the verification requires more time — typically for deep verification or catch-all domains. The result is delivered to your webhookUrl once processing finishes.
​
email
string
The email address submitted for verification.
​
deepVerification
boolean
Indicates whether deep verification was requested.
​
trackingId
string
A unique identifier for this job. Match this against incoming webhook payloads.
​
verificationProgress
string
Current state: In-progress.
​
verificationStatus
string
Current status: Pending until the job completes.
​
createdAt
string
ISO 8601 timestamp of job creation.
​
pending
boolean
Always true for 202 responses, confirming the job is queued.
{
  "email": "john@example.com",
  "deepVerification": true,
  "trackingId": "664f1a2b3c4d5e6f7a8b9c0d",
  "verificationProgress": "In-progress",
  "verificationStatus": "Pending",
  "createdAt": "2024-06-01T10:00:00.000Z",
  "pending": true
}

​
Webhook Payload Schema

Once verification finishes, Clodura POSTs the following payload to your webhookUrl:
FieldTypeDescription
emailstringThe verified email address
deepVerificationbooleantrue if deep verification was used
trackingIdstringDocument ID — matches the ID in the initial response
verificationProgressstringIn-progress or Completed
verificationStatusstringDeliverable, Undeliverable, Risky (Catch-all), or Pending
createdAtstringISO 8601 timestamp of job creation

​
Verification Status Values

StatusMeaning
DeliverableThe email address is valid and messages will be accepted.
UndeliverableThe email address does not exist or will permanently reject mail.
Risky (Catch-all)The domain accepts all email regardless of whether the mailbox exists — deliverability cannot be confirmed.
PendingVerification is still in progress (only seen in 202 responses).

​
Error Codes

StatusMeaning
400Bad request — email format is invalid
402Payment required — credits exhausted; upgrade your plan or add credits
403Forbidden — email verification is not available on your current plan
500Internal server error — an unexpected error occurred