Menu Close

email verification

wordpress

Join our happy API customers and acquire your API secret right here today!

Here you can easily find out more about the total performance of the Bouncer API, including how to develop requests, inspect end results and also examine the available equilibrium.

Should you as if to see API Recommendation, examine it out listed here.

  • Create an API vital

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

Once enrolled and logged in, click on << API>> on the left navigation. You will certainly locate your API secret under the Available harmony segment.

  • Requests limits

The single verification API is restricted to one hundred demands every moment.

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

  • The set ask for

POST/ v1/email/verify/ set

All gets in touchwithmade to the Bouncer API have to be actually made using HTTPS. Eachtelephone call needs to also feature the API vital criterion in the header as a x-api-key, along withan API secret you’ ve generated as the value.

Whenever a demand body is needed it should be formatted as JSON and a web content form of application/json have to be actually indicated.

Verify one or numerous emails in a set, offline fashion. This approachis actually encouraged when the top quality of verification is actually of value.Provide an assortment of email addresses, along withnames if needed (optional), as an example: [, ” email “: “john@usebouncer.com”, ” label “: ” John Doe “]

Please ensure to store requestId as it will be actually essential to examine status as well as obtain outcomes for the request.

  • The real-time demand

    • GET/ v1/email/verify

    Our real-time API is made use of throughclients to examine email addresses during access. It certainly not merely checks the syntax and also domain name of the address but additionally the supply of the mailbox.
    Bouncer returns the most ideal feasible end results that manage to acquire within 10 few seconds (max 30).

    This method is actually encouraged when the velocity of verification is actually of value.

    • The feasible feedback standings

    Deliverable &amp;amp;amp;ndash;- risk-free to send out.

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

    Risky &amp;amp;amp;ndash;- the deal withis of poor quality and also may lead to a bounce or even low involvement.

    Unknown &amp;amp;amp;ndash;- our team were actually unable to acquire a feedback from the email provider.

    Result Cause

    Status Deliverable, Reason:

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

    Status Risky, Cause:

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

    low _ highquality &amp;amp;amp;ndash;- Email address possesses top quality problems that may create it an unsafe or even low-value address (disposable/temporary email).

    Status Undeliverable, Cause:

    invalid _ email &amp;amp;amp;ndash;- Specified email is not an authentic email handle syntax.

    invalid _ domain &amp;amp;amp;ndash;- Domain name for email does not exist or has no DNS documents.

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

    Status Unknown, Main Reason:

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

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

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

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

    • Verification improvement tracking

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

    To inspect the development of verification, you can easily utilize our Examine Condition endpoint over.

    Response sample is:

    • Get leads

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

    Download batchresult as JSON. You can strain what to download by condition, eg. download and install only deliverable e-mails.

    • Get balance

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

    • Possible errors

    The API uses standard HTTP mistakes to show the success or even failing of a demand. The 2xx series of reaction codes signify a results, 4xx signifies an inaccuracy coming from the client edge, and a 5xx error indicates a server-side mistake.

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

    200 Excellence

    400 Unfavorable Request

    401 Unauthorized

    403 Unacceptable

    503 Company Not Available

    • GDPR

    As our experts are actually GDPR certified by design, our experts likewise deliver an endpoint to erase totally your asks for, satisfy details that once made use of, the end results linked withthe asks for will certainly be lost.

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

    • API Endorsement

    Should you love to see API Referral, inspect it out listed here.

    • Support

    Please be aware that if whenever you would need extra help coming from our edge, you can easily either reachus by verify email at support@usebouncer.com or even set up an online video chat along withamong our creators listed below.