Verify email addresses to obtain verification status, and deliverability details.
The Email Verification API allows you to verify email addresses, retrieve the deliverability status, and obtain detailed information about the email address.
All API requests should be made to:
https://api.findableplus.comSend a POST request to /email/verify/v1 with the email address in the request body and your authentication token in the header.
Receive a unique verification ID for the submitted email address, which can be used to check the job status and obtain the verification results.
Send a GET request to /email/verify/v1/{id} with the verification ID that was received in the previous step and your authentication token in the header.
Check whether the job has completed. If not, repeat the request after a short delay. Once the job is complete, the response will include the verification status and full deliverability details.
The verification results include a classification and status for the verified email address, plus three flags:
disposable flag indicates whether the email address is a temporary, disposable address.free flag indicates whether the email address is handled by a well-known free email service provider (e.g. Gmail, Yahoo, Outlook/Live/Hotmail).group flag indicates whether the email address may be referring to a well-known group, which could be configured to handle general communication for a whole department or even an entire company (e.g. sales@example.com).| Classification Code | Description |
|---|---|
Deliverable | The email address can be delivered to. |
Disposable | Email address is associated with a known disposable address provider. |
Harmful | The email address is potentially harmful and has been identified as associated to a known trap. |
Unconfirmed | The email address may be deliverable, but Hopewiser are unable to confirm this. (Please review associated status.) |
Undeliverable | The email address cannot be delivered to. |
Unknown | Hopewiser cannot determine whether the email address can be delivered to or not. |
Unverifiable | The email server has been identified as a Catch All, the email address is potentially deliverable to. |
NOTE: New classification codes may be added in the future. As such, it is recommended to handle unknown codes gracefully.
| Status Code | Description |
|---|---|
ConnectionFailure | A connection error occurred whilst performing the email validation. |
ConnectionTimeout | A connection timeout occurred whilst performing the email validation. |
DisposableEmailAddress | The email address is for a disposable mailbox or is provided by a known disposable email address provider. |
DoesNotExist | The email address does not exist. |
FormatError | The format of the email address is syntactically incorrect. |
InternationalUnsupported | The external mail exchanger does not support international mailbox names. |
ServerIsCatchAll | The external mail exchanger accepts fake and non-existent email addresses that are sent to the domain. Therefore, the existence of the individual mailbox cannot be verified. |
SpamTrap | The external mail exchanger hides a spam trap (honeypot). |
Success | Deliverable email address that successfully completed verification. |
TemporarilyUnavailable | The requested mailbox is temporarily unavailable. |
UnhandledException | One or more unhandled exceptions have been thrown during the verification process. |
NOTE: New status codes may be added in the future. As such, it is recommended to handle unknown codes gracefully.
For detailed implementation examples, request parameters, and response formats, see the interactive API reference below.