Join our happy API consumers and obtain your API trick right here right now!
Here you can learn more regarding the overall functionality of the Bouncer API, consisting of just how to generate demands, examine results and also check the on call equilibrium.
Should you as if to view API Endorsement, examine it out below.
-
Create an API essential
If you haven’ t presently, enroll in a Baby bouncer account here.
Once subscribed as well as logged in, select << API>> on the left navigating. You will discover your API key under the On call harmony part.
-
Requests restrictions
The single verification API is confined to 100 asks for every moment.
The bulk verification is actually restricted to 250,000 e-mails every eachdemand.
-
The set request
POST/ v1/email/verify/ set
All calls produced to the Bouncer API have to be actually used HTTPS. Eachtelephone call must also consist of the API key guideline in the header as a x-api-key, withan API secret you’ ve created as the value.
Whenever an ask for body is actually needed it should be actually formatted as JSON and a content type of application/json have to be actually pointed out.
Verify one or multiple emails in a batch, offline way. This strategy is actually suggested when the highquality of verification is actually of value.Provide a range of email addresses, along withnames if required (optional), as an example: [, "]
Please see to it to stashrequestId as it are going to be important to check status as well as receive end results for the request.
The real-time ask for
GET/ v1/email/verify
Our real-time API is actually used throughclients to check out email addresses throughout entrance. It certainly not just checks the phrase structure and also domain of the handle however also the accessibility of the mailbox.
Bouncer comes back the greatest feasible end results that are able to gather within 10 secs (optimum 30).
This approachis actually encouraged when the velocity of verification is actually valuable.
-
The feasible feedback statuses
Deliverable &amp;ndash;- secure to send.
Undeliverable &amp;ndash;- the handle is either syntactically improper or performs not exist
Risky &amp;ndash;- the address is of shabby and also might cause a bounce or even reduced interaction.
Unknown &amp;ndash;- our experts were incapable to obtain a reaction from the email company.
Result Factor
Status Deliverable, Factor:
accepted _ email &amp;ndash;- Email address was allowed.
Status Risky, Main Reason:
low _ deliverability &amp;ndash;- Email deal withappears to be deliverable, but deliverability can easily not be actually ensured (inbox full/catch_ all)
low _ highquality &amp;ndash;- Email deal withhas premium concerns that may make it a risky or low-value deal with(disposable/temporary email).
Status Undeliverable, Explanation:
invalid _ email &amp;ndash;- Defined email is actually certainly not a legitimate email address phrase structure.
invalid _ domain name &amp;ndash;- Domain name for email performs certainly not exist or possesses no DNS files.
rejected _ email &amp;ndash;- Email handle was turned down, email handle performs not exist.
Status Not Known, Reason:
dns _ error &amp;ndash;- Our experts were actually not able to fix DNS documents or even domain is misconfigured.
no _ connect &amp;ndash;- Might not hook up to the SMTP server.
unavailable _ smtp &amp;ndash;- SMTP web server was actually inaccessible to process our request.
unknown &amp;ndash;- An unforeseen mistake has occurred.
-
Verification progress monitoring
GET/ v1/email/verify/ set/ / condition
To check out the development of verification, you can utilize our Inspect Condition endpoint over.
Response example is actually:
-
Get results
Use this endpoint for the end results: GET/v1/email/ verify/batch/
Download set result as JSON. You may filter out what to install throughcondition, eg. download and install merely deliverable e-mails.
-
Get balance
To inspect your readily available harmony, utilize this endpoint: GET/v1/customer/ user/current/credit
-
Possible mistakes
The API uses standard HTTP mistakes to suggest the results or failure of a demand. The 2xx collection of feedback codes signify a results, 4xx indicates a mistake coming from the client edge, and a 5xx error indicates a server-side error.
Here are the HTTP response codes the API utilizes:
200 Effectiveness
400 Unfortunate Ask For
401 Unwarranted
403 Forbidden
503 Service Inaccessible
-
GDPR
As our company are GDPR up to date deliberately, our company additionally offer an endpoint to erase totally your asks for, please keep in mind that once made use of, the outcomes related to the requests will be actually shed.
To delete your data make use of: DELETE/v1/email/ verify/batch/
-
API Reference
Should you like to see API Recommendation, inspect it out here.
-
Support
Please be aware that if whenever you would require extra support from our side, you may either hit our company throughemail verification https://checkmyemailfast.org/ at support@usebouncer.com or even plan a video clip chat along withamong our designers right here.