Join our happy API customers as well as receive your API key listed below today!
Here you can easily discover more about the general capability of the Bouncer API, featuring just how to develop demands, check results and also inspect the available balance.
Should you like to find API Reference, examine it out listed below.
Create an API vital
If you sanctuary’ t presently, register for a Bouncer profile below.
Once enrolled and also logged in, click on < < API>> left wing navigation. You are going to locate your API key under the Readily available equilibrium area.
The single verification API is actually confined to one hundred requests every minute.
The majority verification is actually restricted to 250,000 emails per eachdemand.
The set ask for
POST/ v1/email/verify/ set
All gets in touchwithproduced to the Bouncer API have to be used HTTPS. Eachphone call has to also consist of the API essential criterion in the header as a x-api-key, withan API key you’ ve produced as the value.
Whenever a request body is demanded it ought to be actually formatted as JSON and a content form of application/json must be indicated.
Verify one or even a number of e-mails in a batch, offline way. This strategy is suggested when the quality of verification is of value.Provide a variety of email handles, withtitles if needed (optionally available), for instance: [, “]
Please ensure to stashrequestId as it will definitely be actually needed to check out status as well as receive results for the demand.
The real-time demand
Our real-time API is made use of throughcustomers to inspect email addresses throughout entry. It certainly not only checks the phrase structure and domain name of the address however likewise the schedule of the mail box.
Bouncer returns the most ideal achievable results that have the capacity to gather within 10 seconds (optimum 30).
This strategy is actually advised when the rate of verification is actually of value.
The achievable response statuses
Deliverable &ndash;- risk-free to deliver.
Undeliverable &ndash;- the deal withis actually either syntactically incorrect or does certainly not exist
Risky &ndash;- the deal withis actually of shabby and also might cause a bounce or even reduced interaction.
Unknown &ndash;- our company were incapable to receive a feedback coming from the email carrier.
Status Deliverable, Factor:
accepted _ email &ndash;- Email address was approved.
Status Risky, Main Reason:
low _ deliverability &ndash;- Email address seems deliverable, however deliverability can easily certainly not be promised (inbox full/catch_ all)
low _ premium &ndash;- Email address has premium issues that may make it an unsafe or low-value address (disposable/temporary email).
Status Undeliverable, Factor:
invalid _ email &ndash;- Pointed out email is not a valid email deal withphrase structure.
invalid _ domain &ndash;- Domain name for email carries out certainly not exist or even possesses no DNS records.
rejected _ email &ndash;- Email handle was refused, email deal withdoes certainly not exist.
Status Not Known, Reason:
dns _ mistake &ndash;- We were unable to settle DNS reports or domain name is misconfigured.
no _ attach&ndash;- Could possibly not link to the SMTP server.
unavailable _ smtp &ndash;- SMTP server was actually unavailable to process our ask for.
unknown &ndash;- An unpredicted mistake has actually taken place.
Verification progression tracking
GET/ v1/email/verify/ set/ / standing
To examine the progression of verification, you can utilize our Check out Status endpoint over.
Response sample is actually:
Use this endpoint for the results: GET/v1/email/ verify/batch/ requestId
Download batchresult as JSON. You may strain what to download throughstanding, eg. download and install simply deliverable e-mails.
To inspect your available balance, use this endpoint: GET/v1/customer/ user/current/credit
The API makes use of conventional HTTP inaccuracies to show the results or breakdown of an ask for. The 2xx set of feedback codes show an excellence, 4xx shows a mistake coming from the customer edge, as well as a 5xx error indicates a server-side inaccuracy.
Here are actually the HTTP reaction codes the API takes advantage of:
400 Troubled Request
403 Not Allowed
503 Company Inaccessible
As our experts are GDPR compliant deliberately, we likewise provide an endpoint to erase permanently your requests, feel free to details that as soon as made use of, the end results connected withthe demands will definitely be lost.
To remove your information use: DELETE/v1/email/ verify/batch/
Should you appreciate to view API Referral, inspect it out here.
Please realize that if any time you would certainly need to have additional help from our side, you may either hit us by other at [email protected] or even book a video conversation withamong our programmers right here.