Join our happy API customers and also get your API key right here right now!
Here you can easily learn more about the overall functionality of the Bouncer API, including how to produce demands, check out results and examine the accessible harmony.
Should you like to view API Referral, check it out listed below.
Create an API crucial
If you shelter’ t currently, sign up for a Bouncer profile right here.
Once joined and visited, click << API>> left wing navigation. You are going to discover your API secret under the On call equilibrium part.
The singular verification API is limited to one hundred demands every minute.
The mass verification is actually limited to 250,000 emails per eachask for.
POST/ v1/email/verify/ set
All gets in touchwithproduced to the Bouncer API have to be used HTTPS. Eachtelephone call must additionally include the API key guideline in the header as a x-api-key, withan API secret you’ ve developed as the market value.
Whenever a demand body is needed it needs to be actually formatted as JSON as well as a web content type of application/json should be pointed out.
Verify one or a number of e-mails in a set, offline manner. This procedure is actually highly recommended when the quality of verification is of value.Provide a collection of email addresses, withnames if needed to have (extra), for instance: [, ”]
Please make certain to hold requestId as it are going to be actually important to examine condition and also get results for the demand.
The real-time demand
Our real-time API is actually utilized throughclients to examine email handles during entrance. It not just inspections the syntax and also domain name of the handle yet additionally the supply of the mail box.
Bouncer comes back the most ideal achievable end results that manage to gather within 10 secs (max 30).
This method is actually highly recommended when the speed of verification is actually useful.
The feasible action conditions
Deliverable &ndash;- risk-free to deliver.
Undeliverable &ndash;- the address is either syntactically improper or performs not exist
Risky &ndash;- the deal withis actually of low quality and also might cause a bounce or even low involvement.
Unknown &ndash;- our experts were not able to receive an action coming from the email carrier.
Status Deliverable, Reason:
accepted _ email &ndash;- Email address was taken.
Status Risky, Explanation:
low _ deliverability &ndash;- Email handle seems deliverable, however deliverability can easily certainly not be promised (inbox full/catch_ all)
low _ quality &ndash;- Email address possesses highquality problems that might make it a dangerous or even low-value deal with(disposable/temporary email).
Status Undeliverable, Factor:
invalid _ email &ndash;- Pointed out email is certainly not an authentic email deal withphrase structure.
invalid _ domain name &ndash;- Domain name for email carries out certainly not exist or even has no DNS records.
rejected _ email &ndash;- Email deal withwas actually denied, email address carries out certainly not exist.
Status Unfamiliar, Main Reason:
dns _ error &ndash;- We were actually not able to resolve DNS documents or domain name is misconfigured.
no _ attach&ndash;- Might certainly not link to the SMTP hosting server.
unavailable _ smtp &ndash;- SMTP web server was actually unavailable to refine our ask for.
unknown &ndash;- An unanticipated error has developed.
Verification progress monitoring
GET/ v1/email/verify/ set/ requestId/ condition
To inspect the improvement of verification, you can utilize our Check out Condition endpoint over.
Response example is actually:
Use this endpoint for the end results: GET/v1/email/ verify/batch/
Download set lead as JSON. You may remove what to download and install throughcondition, eg. install merely deliverable e-mails.
To inspect your available equilibrium, use this endpoint: GET/v1/customer/ user/current/credit
The API uses regular HTTP mistakes to signify the success or breakdown of an ask for. The 2xx collection of action codes suggest an effectiveness, 4xx shows an error coming from the customer side, and also a 5xx mistake suggests a server-side inaccuracy.
Here are the HTTP response codes the API makes use of:
400 Troubled Demand
503 Service Inaccessible
As our experts are GDPR up to date deliberately, our experts additionally deliver an endpoint to erase permanently your demands, feel free to keep in mind that when made use of, the end results associated withthe requests will be shed.
To remove your records use: DELETE/v1/email/ verify/batch/ requestId
Should you love to find API Referral, check it out right here.
Please know that if at any moment you will require extra support from our side, you can easily either reachour team throughtake a look at this website at firstname.lastname@example.org or even set up a video clip chat withsome of our developers listed here.