email verification

Join our pleased API consumers as well as obtain your API secret listed below now!

Here you may learn more concerning the total capability of the Bouncer API, consisting of just how to develop asks for, examine end results and also examine the offered harmony.

Should you as if to see API Endorsement, check it out here.

  • Create an API crucial

If you place’ t currently, join a Bouncer account listed below.

Once signed up and logged in, select << API>> on the left navigating. You are going to discover your API key under the Available equilibrium section.

  • Requests limitations

The singular verification API is restricted to one hundred requests per minute.

The bulk verification is actually restricted to 250,000 emails per eachrequest.

  • The batchask for

POST/ v1/email/verify/ set

All gets in touchwithproduced to the Baby bouncer API must be used HTTPS. Eachtelephone call should also include the API vital parameter in the header as a x-api-key, withan API key you’ ve generated as the market value.

Whenever a request physical body is needed it should be formatted as JSON as well as a material kind of application/json should be indicated.

Verify one or multiple e-mails in a set, offline manner. This method is recommended when the top quality of verification is of value.Provide a variety of email addresses, along withnames if needed to have (optionally available), for example: [, «]

Please are sure to stashrequestId as it will be important to examine status as well as get results for the request.

  • The real-time request

  • GET/ v1/email/verify

    Our real-time API is actually used by customers to check email deals within the time of entrance. It not simply examinations the syntax and also domain name of the deal withyet also the accessibility of the mail box.
    Bouncer comes back the very best achievable end results that have the capacity to acquire within 10 few seconds (optimum 30).

    This technique is actually encouraged when the speed of verification is valuable.

    • The possible action standings

    Deliverable &amp;amp;ndash;- secure to deliver.

    Undeliverable &amp;amp;ndash;- the address is actually either syntactically wrong or even performs not exist

    Risky &amp;amp;ndash;- the address is actually of poor quality and may result in a bounce or even low interaction.

    Unknown &amp;amp;ndash;- we were actually not able to acquire a reaction coming from the email provider.

    Result Main Reason

    Status Deliverable, Factor:

    accepted _ email &amp;amp;ndash;- Email address was actually approved.

    Status Risky, Main Reason:

    low _ deliverability &amp;amp;ndash;- Email handle looks deliverable, but deliverability can easily not be actually promised (inbox full/catch_ all)

    low _ premium &amp;amp;ndash;- Email handle has highquality concerns that may make it a risky or even low-value address (disposable/temporary email).

    Status Undeliverable, Factor:

    invalid _ email &amp;amp;ndash;- Pointed out email is actually not a legitimate email deal withphrase structure.

    invalid _ domain &amp;amp;ndash;- Domain for email carries out certainly not exist or even has no DNS files.

    rejected _ email &amp;amp;ndash;- Email deal withwas declined, email address does not exist.

    Status Unknown, Reason:

    dns _ mistake &amp;amp;ndash;- Our team were incapable to solve DNS records or domain name is actually misconfigured.

    no _ connect &amp;amp;ndash;- Could possibly not attachto the SMTP web server.

    unavailable _ smtp &amp;amp;ndash;- SMTP hosting server was inaccessible to refine our demand.

    unknown &amp;amp;ndash;- An unexpected error has actually occurred.

    • Verification progress monitoring

    GET/ v1/email/verify/ set/ requestId/ standing

    To inspect the progression of verification, you may utilize our Check out Standing endpoint over.

    Response sample is actually:

    • Get results

    Use this endpoint for the results: GET/v1/email/ verify/batch/ requestId

    Download batchresult as JSON. You can remove what to download and install throughcondition, eg. download just deliverable e-mails.

    • Get harmony

    To check your on call equilibrium, use this endpoint: GET/v1/customer/ user/current/credit

    • Possible errors

    The API utilizes conventional HTTP errors to indicate the effectiveness or failure of a request. The 2xx collection of reaction codes signify an excellence, 4xx indicates an inaccuracy from the customer side, and also a 5xx error shows a server-side mistake.

    Here are the HTTP reaction codes the API makes use of:

    200 Success

    400 Unfavorable Ask For

    401 Unwarranted

    403 Forbidden

    503 Service Unavailable

    • GDPR

    As our team are GDPR certified deliberately, our company also give an endpoint to remove entirely your asks for, please keep in mind that once used, the outcomes associated withthe asks for will definitely be dropped.

    To erase your records make use of: DELETE/v1/email/ verify/batch/

    • API Recommendation

    Should you appreciate to view API Endorsement, examine it out listed here.

    • Support

    Please realize that if any time you will need extra assistance from our edge, you may either hit our company by email verification at or arrange an online video conversation withone of our programmers right here.