API for email verification

API

With the CaptainVerify API, you can integrate email verification into your own applications. We recommend using the API afterwards because a verification can be more or less long (1 or 2 minutes) so it is better to avoid plugging it into your form directly because you risk losing leads.

API key

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

The request

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

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

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

API Limits

The API is limited to a maximum of 2 simultaneous connections and 50 checks per minute. When integrating the API, make sure that your application does not exceed this limit.

The answer

A json table will be returned with these variables:

Variables	Possible value
success	true, false If authentication has failed, the exhaustion of your credits
message	default : null When the success is false, an error message will be sent.
credits	Credits available on your account
email	The email you want to check
email_normalized	Email standardized, elimination of labels for gmail ... support+test@gmail.com will be support@gmail.com
role	true, false If the email user has a role, eg support@example.com
free	true, false If the email provider is free, ex: Gmail.com
disposable	true, false The email is valid, but disposable after a short period it will no longer be possible to contact the user.
risky	true, false If the email provider is fighting spam and is not a real user
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
result	valid, invalid, unknown The status of the email. if all your credits have been used up, the unknown status will always be returned, so as not to block your application.
details	null, error, smtp_error, antispam_system, email_disable, ok_for_all... Understand why an audit is unknown.