.png&w=256&q=75){kind=small}
API Keys
Manage your API keys for authenticated requests
No API keys yet
API Docs
Email • Find
https://server.mailsfinder.com/api/access-key/email/findEmail
curl.exe -i -X POST "https://server.mailsfinder.com/api/access-key/email/findEmail" -H "Authorization: Bearer API_KEY_***************************" -H "Content-Type: application/json" -d "{\"first_name\":\"John\",\"last_name\":\"Doe\",\"domain\":\"example.com\"}"Request Body
{
"first_name": "John",
"last_name": "Doe",
"domain": "example.com"
}Alternative Body
{
"full_name": "John Doe",
"domain": "example.com"
}Response Example
{
"success": true,
"data": {
"email": "john.doe@example.com",
"confidence": 95,
"status": "found",
"catch_all": false,
"domain": "example.com",
"mx": "mx.example.com",
"time_exec": 350,
"user_name": "john",
"connections": 3,
"ver_ops": 1
},
"message": "Email found"
}Error Example
{
"error": {
"message": "Invalid JSON in request body",
"code": 400
}
}Response Fields
email
The email address found or generated based on the provided name + domain.
status
Whether the email was found (found / not_found / unknown).
confidence
Score (0–100) predicting how accurate the found/generated email is.
catch_all
Indicates whether the domain accepts all emails.
domain
The domain used during lookup.
mx
Mail server (MX record) used by the domain.
time_exec
Time taken to process the request.
user_name
Username portion generated from the name.
connections
Number of SMTP connections attempted.
ver_ops
Number of verification operations executed.
Status Codes
200
We found the email successfully.
400
You forgot to enter required information.
401
You are not logged in.
500
Something went wrong on our side.
Email • Find Bulk
https://server.mailsfinder.com/api/access-key/email/findBulkEmail
curl.exe -i -X POST "https://server.mailsfinder.com/api/access-key/email/findBulkEmail" -H "Authorization: Bearer API_••••••••398e" -H "Content-Type: application/json" -d "[{\"domain\":\"example.com\",\"first_name\":\"John\",\"last_name\":\"Doe\"},{\"domain\":\"example.com\",\"first_name\":\"Jane\",\"last_name\":\"Smith\"}]"Request Body
[
{
"domain": "example.com",
"first_name": "John",
"last_name": "Doe"
},
{
"domain": "example.com",
"first_name": "Jane",
"last_name": "Smith"
}
]Response Example
{
"success": true,
"data": {
"results": [
{
"email": "john.doe@example.com",
"confidence": 95,
"status": "found",
"domain": "example.com",
"first_name": "John",
"last_name": "Doe"
},
{
"email": null,
"confidence": 0,
"status": "not_found",
"domain": "example.com",
"first_name": "Jane",
"last_name": "Smith"
}
],
"totalCredits": 2
}
}Error Example
{
"error": {
"message": "Unauthorized",
"code": 401
}
}Response Fields
results
List of results for each name/domain entry.
results[].email
The email found for this entry (or null if not found).
results[].confidence
Score (0–100) for each individual email prediction.
results[].status
Result for each: found / not_found / unknown.
results[].domain
Domain used for this lookup.
results[].first_name
First name provided for this entry.
results[].last_name
Last name provided for this entry.
totalCredits
Number of credits consumed for the entire bulk operation.
Status Codes
200
All emails were processed.
400
The list you sent is incorrect or incomplete.
401
You are not logged in.
429
You sent too many requests at once.
500
Something went wrong while processing emails.
Email • Verify Bulk
https://server.mailsfinder.com/api/access-key/email/verifyBulkEmail
curl.exe -i -X POST "https://server.mailsfinder.com/api/access-key/email/verifyBulkEmail" -H "Authorization: Bearer API_••••••••398e" -H "Content-Type: application/json" -d "{\"emails\":[\"john.doe@example.com\",\"jane.smith@example.com\"]}"Request Body
{
"emails": [
"john.doe@example.com",
"jane.smith@example.com"
]
}Response Example
{
"success": true,
"data": {
"results": [
{
"email": "john.doe@example.com",
"status": "valid",
"confidence": 90,
"deliverable": true,
"reason": "Accepted",
"catch_all": false,
"domain": "example.com",
"mx": "mx.example.com"
},
{
"email": "jane.smith@example.com",
"status": "invalid",
"confidence": 0,
"deliverable": false,
"reason": "Undeliverable"
}
],
"totalCredits": 2
}
}Error Example
{
"error": {
"message": "email list is required",
"code": 400
}
}Response Fields
results
List of verification results for each email.
results[].email
Email address being checked.
results[].status
valid / invalid / unknown.
results[].confidence
Verification confidence score.
results[].deliverable
Whether the email can receive messages.
results[].reason
Explanation from SMTP server.
results[].catch_all
Whether this domain accepts all emails.
results[].domain
Domain of the email.
results[].mx
Mail server used for verification.
totalCredits
Credits used for the entire verification request.
Status Codes
200
All emails were checked.
400
Your list of emails is missing or incorrect.
401
You are not logged in.
429
You tried verifying too many emails too fast.
500
Verification failed due to server issues.
Email • Verify
https://server.mailsfinder.com/api/access-key/email/verifyEmail
curl.exe -i -X POST "https://server.mailsfinder.com/api/access-key/email/verifyEmail" -H "Authorization: Bearer API_••••••••398e" -H "Content-Type: application/json" -d "{\"email\":\"john.doe@example.com\"}"Request Body
{
"email": "john.doe@example.com"
}Response Example
{
"success": true,
"data": {
"email": "john.doe@example.com",
"status": "valid",
"confidence": 80,
"deliverable": true,
"reason": "OK",
"catch_all": false,
"domain": "example.com",
"mx": "mx.example.com",
"user_name": "john"
},
"message": "Verified"
}Error Example
{
"error": {
"message": "email is required",
"code": 400
}
}Response Fields
email
The email address that was verified.
status
valid / invalid / unknown based on verification.
confidence
Score indicating verification certainty.
deliverable
Whether the mailbox can actually receive emails.
reason
SMTP server message explaining the status.
catch_all
Whether the domain accepts all addresses.
domain
The domain of the email.
mx
Mail server used during verification.
user_name
Username portion extracted from the email.
Status Codes
200
The email was checked successfully.
400
You did not include the email to verify.
401
You are not logged in.
422
The email format is incorrect.
500
The mail server did not respond or failed.