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

Try it

Credentials

Runs against your live account — 1 credit will be deducted.

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

1curl -X GET "https://api.verifox.ai/v1/email-validation/john@example.com" \2  -H "X-API-Key: vfx_your_api_key"
1{2  "email": "john@example.com",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

Try it

Credentials

Runs against your live account — 1 credit will be deducted.

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

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": "john@example.com"}'
1{2  "email": "john@example.com",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)

Try it

Credentials

Runs against your live account — 3 credits will be deducted.

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

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": ["john@example.com", "jane@test.io", "bad@invalid"]}'
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

Try it

Credentials

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

1curl -X GET "https://api.verifox.ai/v1/email-validation/bulk/bulk_abc123/progress" \2  -H "X-API-Key: vfx_your_api_key"
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 results for a bulk verification job. Rows are returned as soon as they are verified, so a job still 'processing' returns the rows finished so far — poll until status is 'completed' for the full set.

Path Parameters

jobIdstring*

Job ID

Query Parameters

cursornumberopt

Pagination cursor for fetching next page of results

limitnumberopt

Number of results per page

Try it

Credentials

This endpoint requires an API key. Enter one above to run it — create a key if you don't have one. Your key is used only for this request and is never stored.

1curl -X GET "https://api.verifox.ai/v1/email-validation/bulk/bulk_abc123/results" \2  -H "X-API-Key: vfx_your_api_key"
1{2  "job_id": "69d78b9e37e519a86c186261",3  "status": "completed",4  "total_records": 2,5  "list_name": "March Campaign",6  "results": [7    {8      "email": "john@example.com",9      "isValid": true,10      "reachable": "safe",11      "smtpProvider": "Google",12      "isCatchAll": false,13      "isDisposable": false,14      "isRoleAccount": false,15      "hasFullInbox": false,16      "mxRecords": ["aspmx.l.google.com."],17      "extras": null18    },19    {20      "email": "jane@test.io",21      "isValid": true,22      "reachable": "risky",23      "smtpProvider": "Microsoft 365",24      "isCatchAll": true,25      "isDisposable": false,26      "isRoleAccount": false,27      "hasFullInbox": false,28      "mxRecords": ["test-io.mail.protection.outlook.com."],29      "extras": null30    }31  ],32  "next_cursor": null,33  "total": 234}