API Reference · v1

Email Validation

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

Base URLapi.verifox.ai/v1AuthX-API-Key headerRate limit60 req/minFormatJSON over HTTPSLatency~380ms

Get Started Free
GET Auth 1 cr

Verify Email (GET)

/v1/email-validation/:email

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

emailstring*

Email address to verify

Query Parameters

proxybooleanopt

Use a proxy for the SMTP check

1curl -X GET "https://api.verifox.ai/v1/email-validation/[email protected]" \2  -H "X-API-Key: vfx_your_api_key"
200 - Response
1{2  "email": "[email protected]",3  "domain": "example.com",4  "isValid": true,5  "reachable": "safe",6  "syntax": true,7  "smtp": {8    "hostExists": true,9    "fullInbox": false,10    "catchAll": false,11    "deliverable": true,12    "disabled": false13  },14  "mx": {15    "records": ["gmail-smtp-in.l.google.com.", "alt1.gmail-smtp-in.l.google.com."],16    "smtpProvider": "Google",17    "domainAgeDays": 11196,18    "domainCreated": "1995-08-13",19    "validatedHost": "gmail-smtp-in.l.google.com.",20    "hasSPF": true,21    "hasDMARC": true,22    "hasDKIM": false23  },24  "isFree": false,25  "isRole": false,26  "isDisposable": false,27  "hasGravatar": true,28  "suggestion": null,29  "source": "turnix-email",30  "verifiedAt": "2026-03-31T10:30:00Z",31  "score": 9232}
POST Auth 1 cr

Verify Email (POST)

/v1/email-validation

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

Request Body

emailstring*

Email address to verify

proxybooleanopt

Use a proxy for the SMTP check

1curl -X POST "https://api.verifox.ai/v1/email-validation" \2  -H "X-API-Key: vfx_your_api_key" \3  -H "Content-Type: application/json" \4  -d '{"email": "[email protected]"}'
200 - Response
1{2  "email": "[email protected]",3  "domain": "example.com",4  "isValid": true,5  "reachable": "safe",6  "syntax": true,7  "smtp": {8    "hostExists": true,9    "fullInbox": false,10    "catchAll": false,11    "deliverable": true,12    "disabled": false13  },14  "mx": {15    "records": ["gmail-smtp-in.l.google.com."],16    "smtpProvider": "Google",17    "domainAgeDays": 11196,18    "domainCreated": "1995-08-13",19    "hasSPF": true,20    "hasDMARC": true,21    "hasDKIM": false22  },23  "isFree": false,24  "isRole": false,25  "isDisposable": false,26  "hasGravatar": true,27  "suggestion": null,28  "source": "turnix-email",29  "verifiedAt": "2026-03-31T10:30:00Z",30  "score": 9231}
POST Auth 1 cr

Start Bulk Job

/v1/email-validation/bulk

Submit a list of emails for bulk verification. Returns a job ID to poll for results. Up to 100,000 per job.

Request Body

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)

1curl -X POST "https://api.verifox.ai/v1/email-validation/bulk" \2  -H "X-API-Key: vfx_your_api_key" \3  -H "Content-Type: application/json" \4  -d '{"input": ["[email protected]", "[email protected]", "bad@invalid"]}'
200 - Response
1{2  "jobId": "69d78b9e37e519a86c186261",3  "totalEmails": 34}
GET Auth

Bulk Job Progress

/v1/email-validation/bulk/:jobId/progress

Poll the progress of a running bulk verification job.

Path Parameters

jobIdstring*

Job ID from the bulk request

1curl -X GET "https://api.verifox.ai/v1/email-validation/bulk/bulk_abc123/progress" \2  -H "X-API-Key: vfx_your_api_key"
200 - Response
1{2  "job_id": "69d78b9e37e519a86c186261",3  "total_records": 1000,4  "processed_records": 420,5  "status": "processing",6  "error": null,7  "created_at": "2026-03-31T10:30:00Z",8  "completed_at": null,9  "list_name": "March Campaign",10  "progress": 42,11  "summary": {12    "total_safe": 200,13    "total_risky": 50,14    "total_invalid": 150,15    "total_unknown": 2016  }17}
GET Auth

Bulk Job Results

/v1/email-validation/bulk/:jobId/results

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

Path Parameters

jobIdstring*

Job ID

Query Parameters

cursornumberopt

Pagination cursor for fetching next page of results

limitnumberopt

Number of results per page

1curl -X GET "https://api.verifox.ai/v1/email-validation/bulk/bulk_abc123/results" \2  -H "X-API-Key: vfx_your_api_key"
200 - Response
1{2  "job_id": "69d78b9e37e519a86c186261",3  "status": "completed",4  "total_records": 3,5  "list_name": "March Campaign",6  "results": [7    { "email": "[email protected]", "isValid": true, "reachable": "safe" },8    { "email": "[email protected]", "isValid": true, "reachable": "risky" },9    { "email": "bad@invalid", "isValid": false, "reachable": "invalid" }10  ],11  "next_cursor": null,12  "total": 313}