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. |
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. |