email verification

Join our pleased API consumers and receive your API trick listed below right now!

Here you can easily find out more regarding the general capability of the Baby bouncer API, including how to generate demands, examine outcomes as well as examine the accessible balance.

Should you like to observe API Endorsement, examine it out listed below.

  • Create an API key

If you sanctuary’ t actually, join a Bouncer account here.

Once registered and also visited, select <> left wing navigation. You will definitely locate your API key under the Readily available equilibrium part.

  • Requests restrictions

The singular verification API is limited to 100 asks for per min.

The majority verification is actually confined to 250,000 e-mails per eachask for.

  • The set demand

POST/ v1/email/verify/ set

All gets in touchwithmade to the Baby bouncer API need to be used HTTPS. Eachtelephone call should also include the API key specification in the header as a x-api-key, withan API secret you’ ve created as the worth.

Whenever a demand body system is actually required it needs to be formatted as JSON and also an information kind of application/json have to be indicated.

Verify one or numerous emails in a batch, offline method. This technique is suggested when the quality of verification is actually of value.Provide a range of email addresses, along withnames if needed (optionally available), for instance: [, “]

Please make sure to stashrequestId as it will certainly be required to examine status and get results for the request.

  • The real-time demand

  • GET/ v1/email/verify

    Our real-time API is utilized throughclients to check email deals withthroughout access. It certainly not simply inspections the syntax and domain of the handle but likewise the accessibility of the mailbox.
    Bouncer returns the most ideal achievable results that have the ability to acquire within 10 seconds (max 30).

    This technique is suggested when the rate of verification is actually useful.

    • The possible action statuses

    Deliverable &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- secure to send out.

    Undeliverable &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- the address is either syntactically improper or even carries out not exist

    Risky &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- the handle is of low quality and also may result in a bounce or even low engagement.

    Unknown &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- our team were actually incapable to acquire a response coming from the email supplier.

    Result Main Reason

    Status Deliverable, Reason:

    accepted _ email &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Email handle was actually taken.

    Status Risky, Reason:

    low _ deliverability &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Email handle appears to be deliverable, however deliverability can easily not be actually assured (inbox full/catch_ all)

    low _ premium &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Email address has premium problems that might produce it an unsafe or even low-value address (disposable/temporary email).

    Status Undeliverable, Main Reason:

    invalid _ email &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Pointed out email is actually certainly not an authentic email address syntax.

    invalid _ domain name &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Domain name for email performs certainly not exist or even has no DNS reports.

    rejected _ email &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Email address was actually rejected, email deal withcarries out certainly not exist.

    Status Unfamiliar, Main Reason:

    dns _ error &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Our company were incapable to deal withDNS files or even domain is misconfigured.

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

    unavailable _ smtp &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- SMTP server was not available to process our ask for.

    unknown &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- An unpredicted mistake has happened.

    • Verification progress monitoring

    GET/ v1/email/verify/ set/ requestId/ condition

    To examine the improvement of verification, you can easily utilize our Inspect Status endpoint above.

    Response sample is actually:

    • Get results

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

    Download batchresult as JSON. You can easily strain what to install throughcondition, eg. download and install simply deliverable e-mails.

    • Get balance

    To examine your offered harmony, utilize this endpoint: GET/v1/customer/ user/current/credit

    • Possible mistakes

    The API makes use of standard HTTP errors to show the success or failure of an ask for. The 2xx series of reaction codes indicate an effectiveness, 4xx signifies an error from the customer side, and also a 5xx inaccuracy signifies a server-side inaccuracy.

    Here are actually the HTTP feedback codes the API takes advantage of:

    200 Excellence

    400 Unfavorable Demand

    401 Unapproved

    403 Unacceptable

    503 Service Not Available

    • GDPR

    As our team are GDPR certified by design, our team likewise give an endpoint to erase completely your requests, please keep in mind that when used, the results connected withthe asks for will definitely be actually lost.

    To remove your information utilize: DELETE/v1/email/ verify/batch/

    • API Endorsement

    Should you like to see API Reference, examine it out listed below.

    • Support

    Please understand that if whenever you would certainly need added assistance coming from our side, you may either hit our company throughdecisive hyperlink at or even set up an online video conversation withsome of our creators below.