email verification

Join our happy API customers as well as obtain your API trick below now!

Here you can easily find out more about the overall functionality of the Baby bouncer API, consisting of how to produce asks for, inspect outcomes and check the accessible harmony.

Should you as if to observe API Endorsement, check it out below.

  • Create an API vital

If you place’ t already, enroll in a Bouncer profile here.

Once subscribed and also visited, click on << API>> on the left navigating. You are going to discover your API secret under the On call balance part.

  • Requests limitations

The singular verification API is restricted to 100 requests per moment.

The mass verification is actually limited to 250,000 emails every eachask for.

  • The set ask for

POST/ v1/email/verify/ set

All phones created to the Baby bouncer API should be actually made using HTTPS. Eachtelephone call must likewise consist of the API essential guideline in the header as a x-api-key, along withan API key you’ ve created as the worth.

Whenever a demand physical body is actually needed it should be actually formatted as JSON and an information sort of application/json need to be actually pointed out.

Verify one or even several emails in a batch, offline method. This technique is actually encouraged when the quality of verification is actually of value.Provide a selection of email handles, along withlabels if needed (extra), for example: [» email «: «jane@usebouncer.com», » name «: » Jane Doe «, » email «: «john@usebouncer.com», » name «: » John Doe «]

Please are sure to hold requestId as it will definitely be actually essential to examine condition and also obtain results for the ask for.

  • The real-time demand

  • GET/ v1/email/verify

    Our real-time API is made use of by customers to examine email deals withduring entry. It certainly not simply inspections the phrase structure as well as domain name of the address but additionally the schedule of the mail box.
    Bouncer comes back the most ideal feasible end results that are able to gather within 10 few seconds (maximum 30).

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

    • The possible feedback statuses

    Deliverable –- secure to send.

    Undeliverable –- the deal withis actually either syntactically improper or even does certainly not exist

    Risky –- the address is of poor quality as well as might result in a bounce or reduced interaction.

    Unknown –- our experts were actually incapable to get a reaction coming from the email company.

    Result Explanation

    Status Deliverable, Factor:

    accepted _ email –- Email deal withwas accepted.

    Status Risky, Factor:

    low _ deliverability –- Email address looks deliverable, yet deliverability can easily not be promised (inbox full/catch_ all)

    low _ highquality –- Email handle possesses quality concerns that might make it a high-risk or even low-value handle (disposable/temporary email).

    Status Undeliverable, Explanation:

    invalid _ email –- Indicated email is certainly not a legitimate email address phrase structure.

    invalid _ domain –- Domain name for email performs certainly not exist or even possesses no DNS reports.

    rejected _ email –- Email deal withwas refused, email address does not exist.

    Status Unidentified, Reason:

    dns _ error –- Our team were not able to settle DNS reports or domain is misconfigured.

    no _ link –- Might not attachto the SMTP web server.

    unavailable _ smtp –- SMTP web server was inaccessible to refine our demand.

    unknown –- An unanticipated error has happened.

    • Verification development monitoring

    GET/ v1/email/verify/ batch/ / condition

    To check the progress of verification, you may utilize our Check out Standing endpoint over.

    Response example is:

    • Get leads

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

    Download set lead as JSON. You can easily strain what to install by standing, eg. download and install merely deliverable e-mails.

    • Get balance

    To examine your readily available equilibrium, use this endpoint: GET/v1/customer/ user/current/credit

    • Possible mistakes

    The API makes use of conventional HTTP errors to indicate the excellence or even failing of a request. The 2xx set of feedback codes signify an effectiveness, 4xx signifies a mistake coming from the client side, and also a 5xx mistake indicates a server-side mistake.

    Here are the HTTP feedback codes the API makes use of:

    200 Excellence

    400 Unpleasant Ask For

    401 Unauthorized

    403 Unacceptable

    503 Solution Unavailable

    • GDPR

    As our company are actually GDPR up to date by design, we additionally supply an endpoint to erase entirely your requests, feel free to keep in mind that as soon as used, the results related to the asks for will be shed.

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

    • API Recommendation

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

    • Support

    Please understand that if any time you would require added support coming from our edge, you can either hit our company by free email on line at support@usebouncer.com or arrange a video chat withone of our programmers listed below.