email verification0
Join our happy API consumers as well as receive your API secret right here now!
Here you can easily learn more about the general capability of the Baby bouncer API, featuring exactly how to generate asks for, check results and also examine the offered equilibrium.
Should you suchas to find API Reference, inspect it out listed here.
-
Create an API vital
If you haven’ t presently, enroll in a Bouncer account right here.
Once registered and visited, select << API>> on the left navigation. You will definitely locate your API trick under the Readily available balance area.
-
Requests limits
The single verification API is limited to 100 asks for every minute.
The bulk verification is limited to 250,000 emails every eachrequest.
-
The batchrequest
POST/ v1/email/verify/ set
All calls created to the Bouncer API need to be actually made using HTTPS. Eachphone call must also include the API vital specification in the header as a x-api-key, withan API key you’ ve generated as the market value.
Whenever an ask for body is required it must be actually formatted as JSON as well as a content kind of application/json must be actually pointed out.
Verify one or a number of emails in a batch, offline manner. This procedure is recommended when the highquality of verification is actually of value.Provide a selection of email addresses, withtitles if required (extra), as an example: [, » email «: «john@usebouncer.com», » name «: » John Doe «]
Please make certain to hold requestId as it will definitely be actually important to examine standing and receive end results for the request.
The real-time demand
GET/ v1/email/verify
Our real-time API is actually used throughclients to check email deals withduring entry. It certainly not just inspections the syntax and domain name of the address but likewise the accessibility of the mail box.
Bouncer comes back the most effective feasible results that have the capacity to compile within 10 secs (maximum 30).
This procedure is suggested when the speed of verification is actually valuable.
-
The possible action conditions
Deliverable &ndash;- risk-free to deliver.
Undeliverable &ndash;- the address is either syntactically inaccurate or even performs certainly not exist
Risky &ndash;- the handle is actually of poor quality and might cause a bounce or low involvement.
Unknown &ndash;- our company were not able to get a response coming from the email provider.
Result Cause
Status Deliverable, Main Reason:
accepted _ email &ndash;- Email deal withwas actually accepted.
Status Risky, Factor:
low _ deliverability &ndash;- Email handle seems deliverable, however deliverability may not be assured (inbox full/catch_ all)
low _ premium &ndash;- Email handle possesses highquality concerns that may create it a dangerous or even low-value deal with(disposable/temporary email).
Status Undeliverable, Factor:
invalid _ email &ndash;- Defined email is actually not a legitimate email address phrase structure.
invalid _ domain &ndash;- Domain name for email does certainly not exist or even possesses no DNS reports.
rejected _ email &ndash;- Email handle was declined, email handle carries out certainly not exist.
Status Unidentified, Explanation:
dns _ error &ndash;- Our company were incapable to address DNS records or even domain is actually misconfigured.
no _ attach&ndash;- Might certainly not attachto the SMTP hosting server.
unavailable _ smtp &ndash;- SMTP server was unavailable to process our request.
unknown &ndash;- An unexpected mistake has taken place.
-
Verification development monitoring
GET/ v1/email/verify/ batch/ requestId/ status
To examine the progress of verification, you can use our Check Standing endpoint above.
Response sample is actually:
-
Get results
Use this endpoint for the outcomes: GET/v1/email/ verify/batch/
Download set lead as JSON. You can easily remove what to download and install by standing, eg. install just deliverable emails.
-
Get equilibrium
To inspect your on call balance, use this endpoint: GET/v1/customer/ user/current/credit
-
Possible mistakes
The API takes advantage of regular HTTP inaccuracies to signify the results or failing of a demand. The 2xx collection of action codes show an effectiveness, 4xx signifies an error coming from the customer side, and a 5xx inaccuracy signifies a server-side error.
Here are the HTTP action codes the API makes use of:
200 Excellence
400 Unfortunate Request
401 Unwarranted
403 Not Allowed
503 Service Inaccessible
-
GDPR
As our team are GDPR up to date deliberately, our team also provide an endpoint to delete totally your asks for, feel free to keep in mind that as soon as utilized, the results associated withthe demands will definitely be dropped.
To remove your records make use of: DELETE/v1/email/ verify/batch/ requestId
-
API Endorsement
Should you enjoy to find API Referral, inspect it out right here.
-
Support
Please realize that if at any moment you would certainly require additional assistance from our edge, you may either hit our company by email verification https://www.checkmyemailfast.org/ at support@usebouncer.com or book an online video conversation withamong our creators right here.
Comments are closed.