Join our happy API customers and also obtain your API secret below right now!
Here you can learn more concerning the total performance of the Baby bouncer API, featuring exactly how to make demands, check out end results and check out the on call balance.
Should you just like to see API Endorsement, examine it out here.
-
Create an API vital
If you haven’ t already, sign up for a Baby bouncer profile listed here.
Once joined and also logged in, click on << API>> on the left navigating. You will locate your API secret under the Available harmony segment.
-
Requests limitations
The singular verification API is confined to 100 requests every minute.
The mass verification is actually limited to 250,000 e-mails per eachask for.
-
The set demand
POST/ v1/email/verify/ set
All gets in touchwithhelped make to the Baby bouncer API have to be actually made using HTTPS. Eachcall needs to additionally consist of the API crucial parameter in the header as a x-api-key, along withan API secret you’ ve generated as the value.
Whenever a demand body system is demanded it ought to be formatted as JSON and also a web content type of application/json have to be actually defined.
Verify one or multiple e-mails in a set, offline fashion. This procedure is recommended when the premium of verification is actually of value.Provide a collection of email deals with, withtitles if needed (extra), for instance: [” email “: “jane@usebouncer.com”, ” title “: ” Jane Doe “, ” email “: “john@usebouncer.com”, ” name “: ” John Doe “]
Please are sure to stashrequestId as it are going to be essential to examine standing and also acquire end results for the demand.
The real-time request
GET/ v1/email/verify
Our real-time API is utilized by customers to inspect email deals withthroughout entry. It certainly not merely checks the phrase structure and domain of the deal withhowever additionally the supply of the mail box.
Bouncer returns the very best achievable end results that are able to collect within 10 few seconds (maximum 30).
This technique is actually highly recommended when the velocity of verification is actually of value.
-
The achievable response standings
Deliverable &ndash;- risk-free to send.
Undeliverable &ndash;- the handle is either syntactically incorrect or even does certainly not exist
Risky &ndash;- the handle is actually of low quality and might result in a bounce or reduced engagement.
Unknown &ndash;- our company were actually unable to obtain an action from the email service provider.
Result Cause
Status Deliverable, Main Reason:
accepted _ email &ndash;- Email deal withwas actually allowed.
Status Risky, Reason:
low _ deliverability &ndash;- Email handle looks deliverable, but deliverability may certainly not be promised (inbox full/catch_ all)
low _ quality &ndash;- Email handle possesses top quality concerns that may create it a risky or low-value handle (disposable/temporary email).
Status Undeliverable, Main Reason:
invalid _ email &ndash;- Defined email is not a legitimate email address phrase structure.
invalid _ domain &ndash;- Domain name for email performs certainly not exist or even possesses no DNS records.
rejected _ email &ndash;- Email deal withwas actually rejected, email deal withcarries out certainly not exist.
Status Unknown, Cause:
dns _ mistake &ndash;- Our experts were incapable to solve DNS files or domain name is actually misconfigured.
no _ attach&ndash;- Can certainly not connect to the SMTP server.
unavailable _ smtp &ndash;- SMTP server was not available to refine our demand.
unknown &ndash;- An unforeseen inaccuracy has actually developed.
-
Verification progression tracking
GET/ v1/email/verify/ set/ requestId/ standing
To check out the development of verification, you can easily utilize our Check out Status endpoint above.
Response sample is actually:
-
Get leads
Use this endpoint for the results: GET/v1/email/ verify/batch/
Download set result as JSON. You can strain what to download and install throughstanding, eg. download and install merely deliverable emails.
-
Get equilibrium
To examine your on call balance, utilize this endpoint: GET/v1/customer/ user/current/credit
-
Possible mistakes
The API takes advantage of standard HTTP mistakes to indicate the effectiveness or failing of a demand. The 2xx series of feedback codes indicate an excellence, 4xx indicates an error from the customer edge, as well as a 5xx inaccuracy suggests a server-side mistake.
Here are the HTTP reaction codes the API uses:
200 Excellence
400 Troubled Ask For
401 Unwarranted
403 Forbidden
503 Company Not Available
-
GDPR
As our team are GDPR compliant deliberately, our team likewise give an endpoint to remove completely your demands, feel free to details that when made use of, the results associated withthe demands will certainly be dropped.
To remove your information use: DELETE/v1/email/ verify/batch/
-
API Reference
Should you love to find API Recommendation, check it out listed below.
-
Support
Please know that if at any time you will need additional assistance coming from our edge, you can easily either hit our company by email verification https://checkmyemailfast.org at support@usebouncer.com or arrange a video recording chat along withone of our designers listed below.