email verification


Join our delighted API consumers and obtain your API key below now!

Here you can learn more regarding the general functionality of the Bouncer API, consisting of how to generate demands, check out end results as well as inspect the readily available harmony.

Should you just like to observe API Referral, inspect it out right here.

  • Create an API essential

If you haven’ t presently, register for a Baby bouncer profile below.

Once registered and also logged in, select << API>> on the left navigating. You are going to discover your API trick under the On call harmony section.

  • Requests restrictions

The solitary verification API is limited to 100 requests per moment.

The mass verification is confined to 250,000 emails per eachdemand.

  • The batchdemand

POST/ v1/email/verify/ set

All phones made to the Bouncer API should be actually used HTTPS. Eachphone call needs to also include the API essential criterion in the header as a x-api-key, withan API trick you’ ve created as the value.

Whenever a demand body is demanded it should be formatted as JSON as well as a material kind of application/json have to be actually indicated.

Verify one or even several emails in a batch, offline manner. This approachis actually suggested when the premium of verification is actually of value.Provide an array of email deals with, withlabels if needed (extra), as an example: [” email “: “”, ” label “: ” Jane Doe “, “]

Please see to it to hold requestId as it will definitely be necessary to examine status and also acquire results for the demand.

  • The real-time request

  • GET/ v1/email/verify

    Our real-time API is actually used by clients to check out email addresses throughout access. It not simply inspections the syntax as well as domain name of the deal withhowever also the supply of the mailbox.
    Bouncer comes back the greatest feasible end results that manage to gather within 10 secs (optimum 30).

    This approachis actually encouraged when the velocity of verification is valuable.

    • The possible feedback statuses

    Deliverable &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- safe to send.

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

    Risky &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- the deal withis actually of low quality and also might cause a bounce or reduced engagement.

    Unknown &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- our team were actually not able to receive a reaction coming from the email service provider.

    Result Explanation

    Status Deliverable, Cause:

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

    Status Risky, Reason:

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

    low _ quality &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Email handle has premium problems that might create it an unsafe or even low-value deal with(disposable/temporary email).

    Status Undeliverable, Explanation:

    invalid _ email &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Specified email is actually not a legitimate email deal withsyntax.

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

    rejected _ email &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Email address was actually refused, email address carries out not exist.

    Status Unidentified, Reason:

    dns _ inaccuracy &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Our team were actually unable to settle DNS documents or domain name is misconfigured.

    no _ link &amp;amp;amp;amp;amp;amp;amp;amp;amp;ndash;- Might certainly not link to the SMTP hosting 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 unanticipated inaccuracy has actually developed.

    • Verification improvement monitoring

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

    To check out the progression of verification, you can use our Inspect Standing endpoint over.

    Response sample is actually:

    • Get leads

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

    Download batchlead as JSON. You can easily filter out what to download and install by status, eg. download simply deliverable e-mails.

    • Get harmony

    To inspect your accessible harmony, utilize this endpoint: GET/v1/customer/ user/current/credit

    • Possible mistakes

    The API makes use of conventional HTTP inaccuracies to indicate the success or even failing of an ask for. The 2xx series of feedback codes signify a results, 4xx signifies an error coming from the client edge, and a 5xx inaccuracy indicates a server-side inaccuracy.

    Here are actually the HTTP feedback codes the API utilizes:

    ۲۰۰ Excellence

    ۴۰۰ Bad Ask For

    ۴۰۱ Unwarranted

    ۴۰۳ Forbidden

    ۵۰۳ Service Not Available

    • GDPR

    As our company are GDPR compliant deliberately, we also deliver an endpoint to delete permanently your requests, feel free to note that once utilized, the results associated withthe demands will definitely be actually dropped.

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

    • API Endorsement

    Should you enjoy to observe API Recommendation, inspect it out listed here.

    • Support

    Please know that if any time you would require added help coming from our side, you may either hit us throughwhy not try here at or even book an online video conversation along withamong our creators listed here.


    نظرات بسته اند