email verification

Join our satisfied API clients and get your API trick right here now!

Here you may discover more about the general capability of the Bouncer API, featuring just how to develop demands, examine end results and check out the on call balance.

Should you like to see API Recommendation, check it out right here.

  • Create an API vital

If you shelter’ t presently, subscribe for a Baby bouncer account listed here.

Once joined and also logged in, click << API>> left wing navigating. You will certainly locate your API trick under the Offered balance section.

  • Requests limitations

The solitary verification API is actually restricted to 100 asks for per moment.

The bulk verification is confined to 250,000 emails per eachask for.

  • The batchask for

POST/ v1/email/verify/ batch

All phones produced to the Baby bouncer API have to be actually made using HTTPS. Eachcall needs to additionally feature the API key guideline in the header as a x-api-key, withan API trick you’ ve made as the worth.

Whenever a request body system is actually needed it ought to be formatted as JSON as well as an information form of application/json should be actually defined.

Verify one or multiple emails in a set, offline way. This strategy is actually encouraged when the premium of verification is of value.Provide a collection of email handles, along withnames if needed to have (extra), for example: [” email “: “jane@usebouncer.com”, ” label “: ” Jane Doe “, ” email “: “john@usebouncer.com”, ” label “: ” John Doe “]

Please make sure to hold requestId as it will definitely be actually needed to check out status as well as get outcomes for the ask for.

  • The real-time demand

  • GET/ v1/email/verify

    Our real-time API is actually made use of by clients to check out email handles during entrance. It not only inspections the syntax as well as domain of the deal withhowever additionally the availability of the mail box.
    Bouncer returns the most ideal feasible end results that have the ability to collect within 10 few seconds (maximum 30).

    This strategy is recommended when the speed of verification is actually useful.

    • The possible response conditions

    Deliverable &amp;amp;amp;ndash;- risk-free to deliver.

    Undeliverable &amp;amp;amp;ndash;- the handle is actually either syntactically inaccurate or carries out certainly not exist

    Risky &amp;amp;amp;ndash;- the deal withis of poor quality as well as may lead to a bounce or reduced interaction.

    Unknown &amp;amp;amp;ndash;- we were unable to receive a response coming from the email company.

    Result Factor

    Status Deliverable, Main Reason:

    accepted _ email &amp;amp;amp;ndash;- Email deal withwas allowed.

    Status Risky, Explanation:

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

    low _ premium &amp;amp;amp;ndash;- Email deal withhas highquality problems that might create it a high-risk or low-value deal with(disposable/temporary email).

    Status Undeliverable, Factor:

    invalid _ email &amp;amp;amp;ndash;- Defined email is actually not a valid email address phrase structure.

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

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

    Status Unfamiliar, Explanation:

    dns _ error &amp;amp;amp;ndash;- We were actually not able to resolve DNS files or domain is misconfigured.

    no _ attach&amp;amp;amp;ndash;- Might certainly not connect to the SMTP hosting server.

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

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

    • Verification improvement tracking

    GET/ v1/email/verify/ set/ / status

    To examine the progression of verification, you may use our Check out Condition endpoint above.

    Response sample is:

    • Get results

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

    Download batchlead as JSON. You can remove what to download and install throughstanding, eg. download and install only deliverable emails.

    • Get harmony

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

    • Possible inaccuracies

    The API takes advantage of typical HTTP inaccuracies to signify the effectiveness or even failure of a demand. The 2xx series of action codes indicate an effectiveness, 4xx indicates a mistake coming from the customer edge, and also a 5xx mistake suggests a server-side mistake.

    Here are the HTTP reaction codes the API takes advantage of:

    200 Effectiveness

    400 Unfavorable Demand

    401 Unwarranted

    403 Unacceptable

    503 Solution Not Available

    • GDPR

    As our team are GDPR up to date by design, our company also deliver an endpoint to delete permanently your requests, please details that once made use of, the results related to the requests are going to be actually dropped.

    To remove your data use: DELETE/v1/email/ verify/batch/ requestId

    • API Endorsement

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

    • Support

    Please understand that if whenever you will require added help from our side, you may either reachus throughemail address sites at support@usebouncer.com or set up a video clip conversation withsome of our developers below.