Join our satisfied API customers and also receive your API key here today!
Here you can easily discover more regarding the total functions of the Bouncer API, including exactly how to generate requests, check outcomes and also check out the accessible harmony.
Should you just like to find API Referral, check it out right here.
Create an API essential
If you sanctuary’ t currently, subscribe for a Baby bouncer account listed below.
Once subscribed as well as visited, click on << API>> left wing navigating. You will certainly locate your API trick under the Accessible balance part.
The singular verification API is confined to one hundred demands every minute.
The mass verification is actually limited to 250,000 emails per eachrequest.
POST/ v1/email/verify/ batch
All phones produced to the Bouncer API should be used HTTPS. Eachcall must additionally include the API crucial specification in the header as a x-api-key, along withan API trick you’ ve generated as the value.
Whenever a request body system is actually demanded it should be formatted as JSON and also a web content kind of application/json must be indicated.
Verify one or several e-mails in a batch, offline fashion. This approachis actually encouraged when the premium of verification is of value.Provide a variety of email handles, along withlabels if needed (optionally available), for example: [" email ": "firstname.lastname@example.org", " name ": " Jane Doe ", " email ": "email@example.com", " title ": " John Doe "]
Please ensure to keep requestId as it will certainly be needed to check condition as well as get outcomes for the ask for.
The real-time demand
Our real-time API is used throughcustomers to check email deals withduring access. It not merely checks the phrase structure and also domain name of the handle but additionally the supply of the mailbox.
Bouncer comes back the very best possible end results that manage to acquire within 10 secs (optimum 30).
This method is actually recommended when the speed of verification is actually useful.
The achievable response conditions
Deliverable –- secure to send.
Undeliverable –- the deal withis actually either syntactically improper or does not exist
Risky –- the handle is of shabby and may cause a bounce or low engagement.
Unknown –- our company were actually unable to obtain a reaction from the email company.
Result Main Reason
Status Deliverable, Explanation:
accepted _ email –- Email handle was taken.
Status Risky, Main Reason:
low _ deliverability –- Email address looks deliverable, yet deliverability may not be actually ensured (inbox full/catch_ all)
low _ premium –- Email address possesses premium concerns that may produce it a dangerous or even low-value handle (disposable/temporary email).
Status Undeliverable, Factor:
invalid _ email –- Defined email is not a valid email address syntax.
invalid _ domain –- Domain for email does not exist or even has no DNS reports.
rejected _ email –- Email address was declined, email deal withperforms certainly not exist.
Status Unknown, Reason:
dns _ error –- Our team were actually incapable to resolve DNS documents or even domain is misconfigured.
no _ link –- Can not connect to the SMTP server.
unavailable _ smtp –- SMTP server was not available to refine our request.
unknown –- An unanticipated mistake has occurred.
Verification progress tracking
GET/ v1/email/verify/ set/ requestId/ condition
To examine the progress of verification, you can easily utilize our Check out Status endpoint over.
Response sample is:
Use this endpoint for the end results: GET/v1/email/ verify/batch/ requestId
Download batchresult as JSON. You can easily strain what to download by condition, eg. install simply deliverable emails.
To examine your available balance, use this endpoint: GET/v1/customer/ user/current/credit
The API uses conventional HTTP errors to suggest the results or even failing of an ask for. The 2xx series of reaction codes indicate a results, 4xx shows an error from the customer side, and also a 5xx inaccuracy suggests a server-side mistake.
Here are actually the HTTP reaction codes the API takes advantage of:
400 Bad Demand
403 Not Allowed
503 Company Not Available
As our team are actually GDPR up to date by design, our experts additionally offer an endpoint to erase permanently your requests, satisfy note that once utilized, the results related to the asks for will certainly be dropped.
To remove your data use: DELETE/v1/email/ verify/batch/ requestId
Should you enjoy to observe API Referral, examine it out listed here.
Please realize that if any time you would certainly need additional support from our side, you may either hit our company by email verification https://checkmyemailfast.org at firstname.lastname@example.org or book an online video conversation along withone of our programmers right here.