API V2

Version 2 of the Captain Verify API is now available and it includes new features. If you are looking for a reliable way to verify the validity of your emails, you can integrate Captain Verify's email verification API into your own applications. We advise to use the API a posteriori because a verification can be more or less long (1 minute).

API Key

An account is required to generate the key for the API, this is what will give you access to the service.

API limits

The API is limited to one (1) connection and 50 checks per minute. When integrating the API, make sure your application does not exceed this limit.

The request

To make a request to the API, simply call the GET protocol at this URL:

https://api.captainverify.com/v2/verify?apikey=XXXXXXXXXXXXXXXXXXXX&email=john.doe@gmail.com

Replace john.doe@gmail.com with your email to verify.

The answer

A json table will be returned with these variables:

                        {
"credits":870,
"result":"invalid",
"details":"unknown_email",
"free":true,
"role":false,
"disposable":false,
"ok_for_all":false,
"protected":false,
"did_you_mean":"john.doe@gmail.com",
"email":"john.doe@gmail.com",
"email_normalized":"john.doe@gmail.com",
"success":true,
"message":null
}
Variables Possible value
credits Credits available in your account.
result valid, invalid, risky, unknown
The status of the email. if all your credits have been exhausted, the unknown status will always be returned, so as not to block your application.
details null, email error, greylisting, low quality, low deliverability, mailboxfull...
Understand the result of an audit.
free true, false
If the email provider is free, eg Gmail.com.
role true, false
If the email user has a role, ex: support@example.com.
disposable true, false
The email is valid, but disposable after a short time it will no longer be possible to contact the user.
ok_for_all true, false
Ok for all: the remote mail server accepts all e-mails (catch-all).
protected true, false
The email is protected by a proprietary antispam solution
mailboxfull true, false
The email address is full. She can no longer receive mail
did_you_mean default : null
If for example, the email is john.doe@gmil.com, the API will send you a proposal like john.doe@gmail.com.
email The email you want to verify.
email_normalized Email has normalized, removing tags for gmail...support+test@gmail.com will be support@gmail.com.
success true, false
If authentication failed, your credits are exhausted.
message default : null
When the success is false, an error message will be sent.
To check the validity of your emails with our API. Register Now
100 free email credits