APIEmail Validation

Email Validation

/v1/email-validation·5 endpoints

Verify individual emails or run bulk jobs. Checks syntax, SMTP deliverability, disposable providers, role accounts, and more.

GET/v1/email-validation/:emailAuth1cr

Verify Email (GET)

Verify a single email by passing it as a URL parameter. Returns comprehensive validation results including SMTP checks, disposable detection, and deliverability status.

Path Parameters

Parameter	Type	Required	Description
`email`	`string`	Required	Email address to verify

emailstring*

Email address to verify

Query Parameters

Parameter	Type	Required	Description
`proxy`	`boolean`	Optional · false	Use proxy for SMTP check

proxybooleanopt

Use proxy for SMTP check

Request

curl -X GET "https://api.verifox.ai/v1/email-validation/john@example.com" \
  -H "X-API-Key: vfx_your_api_key"

Response

{
  "email": "john@example.com",
  "domain": "example.com",
  "isValid": true,
  "reachable": "safe",
  "syntax": true,
  "smtp": {
    "hostExists": true,
    "fullInbox": false,
    "catchAll": false,
    "deliverable": true,
    "disabled": false
  },
  "mx": {
    "records": ["gmail-smtp-in.l.google.com.", "alt1.gmail-smtp-in.l.google.com."],
    "smtpProvider": "Google",
    "domainAgeDays": 11196,
    "domainCreated": "1995-08-13",
    "validatedHost": "gmail-smtp-in.l.google.com.",
    "hasSPF": true,
    "hasDMARC": true,
    "hasDKIM": false
  },
  "isFree": false,
  "isRole": false,
  "isDisposable": false,
  "hasGravatar": true,
  "suggestion": null,
  "source": "turnix-email",
  "verifiedAt": "2026-03-31T10:30:00Z",
  "score": 92
}

POST/v1/email-validationAuth1cr

Verify Email (POST)

Verify a single email via POST. Useful when you prefer not to pass the email in the URL.

Request Body

Parameter	Type	Required	Description
`email`	`string`	Required	Email address to verify
`proxy`	`boolean`	Optional · false	Use proxy for SMTP check

emailstring*

Email address to verify

proxybooleanopt

Use proxy for SMTP check

Request

curl -X POST "https://api.verifox.ai/v1/email-validation" \
  -H "X-API-Key: vfx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "john@example.com"}'

Response

{
  "email": "john@example.com",
  "domain": "example.com",
  "isValid": true,
  "reachable": "safe",
  "syntax": true,
  "smtp": {
    "hostExists": true,
    "fullInbox": false,
    "catchAll": false,
    "deliverable": true,
    "disabled": false
  },
  "mx": {
    "records": ["gmail-smtp-in.l.google.com."],
    "smtpProvider": "Google",
    "domainAgeDays": 11196,
    "domainCreated": "1995-08-13",
    "hasSPF": true,
    "hasDMARC": true,
    "hasDKIM": false
  },
  "isFree": false,
  "isRole": false,
  "isDisposable": false,
  "hasGravatar": true,
  "suggestion": null,
  "source": "turnix-email",
  "verifiedAt": "2026-03-31T10:30:00Z",
  "score": 92
}

POST/v1/email-validation/bulkAuth1cr

Start Bulk Job

Submit a list of emails for bulk verification. Returns a job ID to poll for results. Jobs support up to 100,000 emails.

Request Body

Parameter	Type	Required	Description
`input`	`string[]`	Required	Array of email addresses to verify
`s3_url`	`string`	Optional	S3 URL of uploaded CSV file (alternative to input)
`list_name`	`string`	Optional	Name for the verification list
`email_column`	`string`	Optional	Column name containing emails (for CSV uploads)

inputstring[]*

Array of email addresses to verify

s3_urlstringopt

S3 URL of uploaded CSV file (alternative to input)

list_namestringopt

Name for the verification list

email_columnstringopt

Column name containing emails (for CSV uploads)

Request

curl -X POST "https://api.verifox.ai/v1/email-validation/bulk" \
  -H "X-API-Key: vfx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"input": ["john@example.com", "jane@test.io", "bad@invalid"]}'

Response

{
  "jobId": "69d78b9e37e519a86c186261",
  "totalEmails": 3
}

GET/v1/email-validation/bulk/:jobId/progressAuth

Bulk Job Progress

Poll the progress of a running bulk verification job.

Path Parameters

Parameter	Type	Required	Description
`jobId`	`string`	Required	Job ID from the bulk request

jobIdstring*

Job ID from the bulk request

Request

curl -X GET "https://api.verifox.ai/v1/email-validation/bulk/bulk_abc123/progress" \
  -H "X-API-Key: vfx_your_api_key"

Response

{
  "job_id": "69d78b9e37e519a86c186261",
  "total_records": 1000,
  "processed_records": 420,
  "status": "processing",
  "error": null,
  "created_at": "2026-03-31T10:30:00Z",
  "completed_at": null,
  "list_name": "March Campaign",
  "progress": 42,
  "summary": {
    "total_safe": 200,
    "total_risky": 50,
    "total_invalid": 150,
    "total_unknown": 20
  }
}

GET/v1/email-validation/bulk/:jobId/resultsAuth

Bulk Job Results

Retrieve the completed results for a bulk verification job. Only available when status is 'completed'.

Path Parameters

Parameter	Type	Required	Description
`jobId`	`string`	Required	Job ID

jobIdstring*

Job ID

Query Parameters

Parameter	Type	Required	Description
`cursor`	`number`	Optional	Pagination cursor for fetching next page of results
`limit`	`number`	Optional · 50	Number of results per page

cursornumberopt

Pagination cursor for fetching next page of results

limitnumberopt

Number of results per page

Request

curl -X GET "https://api.verifox.ai/v1/email-validation/bulk/bulk_abc123/results" \
  -H "X-API-Key: vfx_your_api_key"

Response

{
  "job_id": "69d78b9e37e519a86c186261",
  "status": "completed",
  "total_records": 3,
  "list_name": "March Campaign",
  "results": [
    { "email": "john@example.com", "isValid": true, "reachable": "safe" },
    { "email": "jane@test.io", "isValid": true, "reachable": "risky" },
    { "email": "bad@invalid", "isValid": false, "reachable": "invalid" }
  ],
  "next_cursor": null,
  "total": 3
}