Join our delighted API customers and obtain your API key below right now!
Here you may find out more regarding the general capability of the Bouncer API, including how to produce asks for, check results and also examine the offered equilibrium.
Should you just like to view API Reference, examine it out listed here.
Create an API crucial
If you sanctuary’ t currently, enroll in a Baby bouncer profile listed below.
Once subscribed and logged in, click << API>> on the left navigating. You are going to discover your API key under the Accessible balance segment.
The single verification API is restricted to one hundred requests per moment.
The mass verification is confined to 250,000 emails per eachrequest.
The set request
POST/ v1/email/verify/ batch
All calls created to the Bouncer API need to be used HTTPS. Eachcall should likewise include the API essential criterion in the header as a x-api-key, along withan API secret you’ ve made as the worth.
Whenever a request body is actually required it must be actually formatted as JSON and a material form of application/json need to be defined.
Verify one or several emails in a set, offline manner. This procedure is encouraged when the quality of verification is of value.Provide a variety of email handles, withlabels if needed (extra), as an example: [” email “: “firstname.lastname@example.org”, ” title “: ” Jane Doe “, ” email “: “email@example.com”, ” name “: ” John Doe “]
Please see to it to hold requestId as it are going to be important to check status as well as get results for the ask for.
The real-time ask for
Our real-time API is used by clients to check out email handles during entry. It certainly not just checks the syntax and domain name of the deal withbut likewise the schedule of the mail box.
Bouncer comes back the best feasible end results that are able to collect within 10 seconds (maximum 30).
This method is advised when the speed of verification is actually of value.
The achievable action standings
Deliverable –- secure to send.
Undeliverable –- the handle is actually either syntactically inaccurate or does not exist
Risky –- the handle is actually of poor quality as well as might cause a bounce or low engagement.
Unknown –- our company were incapable to obtain a response from the email company.
Status Deliverable, Factor:
accepted _ email –- Email address was allowed.
Status Risky, Reason:
low _ deliverability –- Email handle looks deliverable, but deliverability can easily certainly not be ensured (inbox full/catch_ all)
low _ highquality –- Email address has quality concerns that may create it a high-risk or even low-value address (disposable/temporary email).
Status Undeliverable, Cause:
invalid _ email –- Indicated email is actually certainly not an authentic email handle phrase structure.
invalid _ domain name –- Domain for email carries out certainly not exist or even has no DNS files.
rejected _ email –- Email deal withwas refused, email address performs certainly not exist.
Status Unidentified, Explanation:
dns _ error –- We were unable to deal withDNS documents or domain is actually misconfigured.
no _ connect –- Might not link to the SMTP web server.
unavailable _ smtp –- SMTP web server was actually not available to refine our request.
unknown –- An unexpected mistake has taken place.
Verification improvement monitoring
GET/ v1/email/verify/ batch/ requestId/ status
To check out the development of verification, you may use our Inspect Condition endpoint over.
Response sample is actually:
Use this endpoint for the end results: GET/v1/email/ verify/batch/ requestId
Download batchresult as JSON. You can strain what to download throughstanding, eg. download and install only deliverable e-mails.
To inspect your readily available harmony, utilize this endpoint: GET/v1/customer/ user/current/credit
The API utilizes common HTTP errors to show the success or failure of an ask for. The 2xx series of action codes signify a results, 4xx indicates an inaccuracy coming from the customer edge, and also a 5xx error indicates a server-side mistake.
Here are actually the HTTP response codes the API takes advantage of:
400 Unfavorable Ask For
403 Not Allowed
503 Company Inaccessible
As we are GDPR up to date by design, our company additionally supply an endpoint to remove entirely your demands, satisfy keep in mind that as soon as utilized, the results linked withthe demands are going to be actually lost.
To delete your records utilize: DELETE/v1/email/ verify/batch/
Should you like to view API Recommendation, inspect it out below.
Please understand that if whenever you would certainly need to have added help from our side, you may either reachour team throughhow do i check an email address at firstname.lastname@example.org or plan a video chat along withamong our developers here.