Join our happy API customers and also obtain your API key right here now!
Here you can easily find out more about the total performance of the Bouncer API, consisting of exactly how to make requests, check out end results and also examine the on call equilibrium.
Should you as if to see API Recommendation, inspect it out listed below.
Create an API key
If you sanctuary’ t presently, subscribe for a Baby bouncer profile listed below.
Once signed up as well as visited, click on <> on the left navigation. You are going to discover your API secret under the Readily available harmony part.
The solitary verification API is actually confined to one hundred requests every moment.
The bulk verification is limited to 250,000 emails per eachdemand.
POST/ v1/email/verify/ batch
All calls produced to the Bouncer API need to be actually made using HTTPS. Eachtelephone call needs to also include the API vital parameter in the header as a x-api-key, withan API trick you’ ve produced as the market value.
Whenever a demand physical body is demanded it must be formatted as JSON as well as a content type of application/json need to be actually specified.
Verify one or even numerous emails in a batch, offline manner. This technique is actually encouraged when the premium of verification is actually of value.Provide an array of email handles, withtitles if needed to have (extra), as an example: [, “]
Please are sure to save requestId as it will definitely be actually needed to inspect condition and obtain results for the ask for.
The real-time ask for
Our real-time API is made use of by clients to examine email deals withduring entrance. It certainly not merely examinations the phrase structure and also domain name of the address however additionally the schedule of the mailbox.
Bouncer comes back the most ideal feasible end results that are able to collect within 10 seconds (max 30).
This technique is actually highly recommended when the speed of verification is of value.
The possible response statuses
Deliverable –- safe to deliver.
Undeliverable –- the handle is actually either syntactically wrong or even does not exist
Risky –- the deal withis actually of poor quality and might result in a bounce or low engagement.
Unknown –- our company were actually unable to get a response coming from the email company.
Status Deliverable, Factor:
accepted _ email –- Email address was actually allowed.
Status Risky, Cause:
low _ deliverability –- Email handle seems deliverable, but deliverability can easily not be ensured (inbox full/catch_ all)
low _ top quality –- Email deal withpossesses top quality problems that may create it an unsafe or low-value handle (disposable/temporary email).
Status Undeliverable, Factor:
invalid _ email –- Pointed out email is not a valid email address phrase structure.
invalid _ domain name –- Domain for email does certainly not exist or even possesses no DNS reports.
rejected _ email –- Email address was actually turned down, email handle does certainly not exist.
Status Unfamiliar, Explanation:
dns _ mistake –- Our team were not able to settle DNS reports or even domain name is misconfigured.
no _ attach–- Might certainly not connect to the SMTP web server.
unavailable _ smtp –- SMTP web server was not available to process our request.
unknown –- An unanticipated error has actually taken place.
Verification progress tracking
GET/ v1/email/verify/ batch/ requestId/ standing
To examine the progression of verification, you can utilize our Inspect Status endpoint over.
Response sample is actually:
Use this endpoint for the end results: GET/v1/email/ verify/batch/
Download set result as JSON. You may remove what to download throughstatus, eg. download and install simply deliverable emails.
To examine your accessible harmony, use this endpoint: GET/v1/customer/ user/current/credit
The API makes use of typical HTTP errors to signify the effectiveness or failure of a request. The 2xx set of feedback codes suggest a success, 4xx suggests an error coming from the customer edge, and a 5xx mistake signifies a server-side error.
Here are the HTTP response codes the API utilizes:
400 Unpleasant Ask For
403 Not Allowed
503 Service Inaccessible
As our company are actually GDPR up to date by design, we also offer an endpoint to erase permanently your asks for, satisfy keep in mind that as soon as used, the results associated withthe requests will certainly be actually shed.
To delete your records use: DELETE/v1/email/ verify/batch/ requestId
Should you love to see API Reference, examine it out right here.
Please know that if at any moment you would need extra support from our side, you can easily either hit us throughverify email at firstname.lastname@example.org or even book a video chat along withsome of our designers below.