email verification

Join our happy API clients and receive your API trick here now!

Here you can discover more concerning the general performance of the Bouncer API, including how to develop requests, inspect end results as well as examine the available equilibrium.

Should you like to view API Endorsement, examine it out right here.

  • Create an API key

If you sanctuary’ t presently, register for a Baby bouncer profile right here.

Once signed up and also logged in, select << API>> on the left navigation. You will certainly discover your API trick under the On call harmony area.

  • Requests limitations

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

The bulk verification is limited to 250,000 e-mails every eachask for.

  • The batchask for

POST/ v1/email/verify/ batch

All phones helped make to the Baby bouncer API should be made using HTTPS. Eachphone call should likewise include the API key guideline in the header as a x-api-key, withan API secret you’ ve produced as the value.

Whenever an ask for body is demanded it ought to be actually formatted as JSON and an information sort of application/json must be actually defined.

Verify one or even numerous emails in a set, offline fashion. This method is actually encouraged when the premium of verification is of value.Provide an array of email deals with, withlabels if needed (optional), for example: [, ” email “: “”, ” name “: ” John Doe “]

Please make certain to save requestId as it will be needed to check out standing as well as obtain results for the request.

  • The real-time ask for

  • GET/ v1/email/verify

    Our real-time API is utilized throughclients to inspect email handles throughout access. It not only examinations the phrase structure and domain of the handle yet likewise the supply of the mailbox.
    Bouncer comes back the greatest achievable outcomes that have the ability to compile within 10 seconds (optimum 30).

    This method is actually advised when the velocity of verification is valuable.

    • The achievable feedback standings

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

    Undeliverable &amp;amp;amp;amp;amp;amp;amp;ndash;- the deal withis either syntactically inaccurate or does certainly not exist

    Risky &amp;amp;amp;amp;amp;amp;amp;ndash;- the handle is actually of poor quality and also may cause a bounce or reduced interaction.

    Unknown &amp;amp;amp;amp;amp;amp;amp;ndash;- our company were actually incapable to receive a feedback from the email provider.

    Result Factor

    Status Deliverable, Reason:

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

    Status Risky, Reason:

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

    low _ premium &amp;amp;amp;amp;amp;amp;amp;ndash;- Email handle possesses quality concerns that might produce it a dangerous or low-value deal with(disposable/temporary email).

    Status Undeliverable, Explanation:

    invalid _ email &amp;amp;amp;amp;amp;amp;amp;ndash;- Indicated email is actually certainly not a valid email handle syntax.

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

    rejected _ email &amp;amp;amp;amp;amp;amp;amp;ndash;- Email handle was turned down, email handle does not exist.

    Status Not Known, Explanation:

    dns _ error &amp;amp;amp;amp;amp;amp;amp;ndash;- Our team were incapable to address DNS files or domain is misconfigured.

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

    unavailable _ smtp &amp;amp;amp;amp;amp;amp;amp;ndash;- SMTP web server was unavailable to refine our request.

    unknown &amp;amp;amp;amp;amp;amp;amp;ndash;- An unanticipated error has happened.

    • Verification progression monitoring

    GET/ v1/email/verify/ batch/ requestId/ status

    To inspect the development of verification, you can use our Examine Status endpoint above.

    Response sample is actually:

    • Get results

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

    Download set lead as JSON. You may filter out what to download throughstanding, eg. download and install merely deliverable e-mails.

    • Get harmony

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

    • Possible errors

    The API takes advantage of regular HTTP inaccuracies to show the effectiveness or breakdown of an ask for. The 2xx series of action codes show a results, 4xx suggests an inaccuracy from the client edge, as well as a 5xx inaccuracy shows a server-side mistake.

    Here are the HTTP reaction codes the API utilizes:

    200 Excellence

    400 Bad Ask For

    401 Unapproved

    403 Unacceptable

    503 Company Inaccessible

    • GDPR

    As our company are GDPR up to date by design, we likewise deliver an endpoint to delete entirely your requests, please keep in mind that once utilized, the outcomes linked withthe demands will be actually lost.

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

    • API Endorsement

    Should you love to see API Reference, check it out right here.

    • Support

    Please understand that if any time you would need added assistance from our edge, you can either reachus by email verification at or even plan a video recording conversation withamong our creators below.