API Reference
Validate email addresses programmatically from any language or platform. All endpoints return JSON. Authentication uses your API key in the request header.
Authentication
Every request must include your API key in the x-api-key header. You can create and manage keys on your Account page.
x-api-key: vf_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Keep your API key secret. Never expose it in client-side JavaScript or public repositories.
POST /api/validate/single
Validate one email address. Costs 1 credit per call.
Request body
"email": "user@example.com"
}
curl -X POST https://verifind.name.ng/api/validate/single \
-H "Content-Type: application/json" \
-H "x-api-key: vf_live_your_key_here" \
-d '{"email": "user@example.com"}'POST /api/validate/bulk
Validate up to 500 emails in one request. Costs 1 credit per email in the batch.
"emails": ["user@example.com", "other@gmail.com"]
}
curl -X POST https://verifind.name.ng/api/validate/bulk \
-H "Content-Type: application/json" \
-H "x-api-key: vf_live_your_key_here" \
-d '{"emails": ["user@example.com", "other@gmail.com"]}'The response contains a results array with one object per email.
Response fields
{
"email": "user@example.com",
"score": 87,
"is_valid": true,
"deliverability_band": "Deliverable",
"syntax_pass": true,
"mx_pass": true,
"disposable": false,
"free_provider": false,
"smtp_pass": true,
"reason": null,
"suggestion": null
}emailstringThe email address that was checked
scorenumber0–100 confidence score. 80+ is deliverable.
is_validbooleanTrue if the email is safe to send to
deliverability_bandstringDeliverable / Risky / Uncertain / Undeliverable
syntax_passbooleanEmail format is valid
mx_passbooleanDomain has a working mail server
smtp_passboolean|nullMailbox exists (null if SMTP check skipped)
disposablebooleanThrowaway / temporary email service
free_providerbooleanGmail, Yahoo, Outlook etc.
reasonstring|nullWhy the email failed (when is_valid = false)
suggestionstring|nullDid-you-mean correction for typos
Error codes
200OKRequest succeeded400Bad RequestMissing or invalid email parameter401UnauthorizedMissing or invalid API key402Payment RequiredInsufficient credits429Too Many RequestsRate limit exceeded for your key500Internal Server ErrorSomething went wrong on our end504Gateway TimeoutValidation took too long — reduce batch sizeRate limits
Rate limit
1 req/sec
Monthly quota
100/month
Via dashboard only, no API access
Rate limit
10 req/sec
Monthly quota
10,000/month
Rate limit
50 req/sec
Monthly quota
100,000/month
When rate limited you receive a 429 response. Retry after the number of seconds in the Retry-After header.
Embed widget
Add real-time email validation to any HTML form with one script tag. The widget validates as the user types and shows a result badge next to the input.
<script src="https://verifind.name.ng/widget.js" data-key="vf_live_your_key_here" data-input="#email" data-theme="light"> </script>
data-keyYour API key (required)
data-inputCSS selector for the email input
data-theme"light" or "dark" (default: light)
data-delayDebounce delay in ms (default: 600)
data-on-resultJS callback function name