Verify a full lead in a single call
Send email, IP and phone (whichever you have); we return a single verdict, an overall score and per-channel detail. You pay only for the channels you send.
What you get
Single request
You send email, IP and phone in the body; we return everything together, atomic from your side.
Unified verdict
Accept / review / reject / unknown — a single decision so your downstream logic stays simple.
Weighted overall score
0-100 built only from the channels you sent. Higher = more reliable.
Per-channel score
If you want your own scoring logic, you have the individual email, IP and phone scores.
Log-ready reasons
List of readable codes (email_block, ip_high_risk, phone_offline, etc.) to log and audit decisions.
Billing per actual channel
If a channel fails it is not charged. If an IP is private it is not charged. Transparent in the response.
Compatible with live line status
If you pass live:true, the lead includes the live mobile network status.
Per-channel detail
The response groups email, IP and phone results with one overall verdict. See the /api/v1/lead/verify contract for each channel’s fields.
How it works
We validate the 3 channels in parallel
Email, IP and phone are processed concurrently so their latencies do not add up.
We aggregate verdict and score
Fixed rules combine the results in a verdict (accept/review/reject/unknown) and a weighted overall score.
We charge per actual channel processed
What fails, does not charge. What is invalid or out of scope, does not charge. We report it field by field in the response.
In code
cURLcurl -X POST https://api.byebouncer.com/api/v1/lead/verify \ -H "Authorization: Bearer $BYEBOUNCER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "email": "maria@company.com", "ip": "8.8.8.8", "phone": "+5491141235678", "default_country": "AR", "live": false }'
Frequently asked questions
How much does a combined lead cost?
Sum of the channels you send. Email + IP + local phone = 3 credits (1+1+1). Email + IP + carrier phone = 5 credits (1+1+3). If you also request live line, add 6 more credits.
How is the single verdict built?
We combine per-channel results with fixed rules. If any channel says "block" the verdict is "reject". If any is review and none is reject, "review". If all green, "accept". If no channel resolved, "unknown".
And the overall score?
A weighted 0-100 average over the channels you sent. It does not penalize fields you did not send: if you send only email and phone, the score combines those two.
What else do you return besides the verdict?
The full detail of each channel, same as if you had queried them individually. Email with status and signals, IP with score and signals, phone with verdict and signals, live line if requested. Plus readable verdict reasons.
Can I send only some channels?
Yes. You pass email, ip and/or phone in the body — missing ones are not validated nor charged. Useful when your form only captures some.
What if a channel fails but others do not?
The failed channel gets "error" and the others deliver normally. The failed channel is not charged. Verdict is computed from the channels that did resolve.
Does this replace my internal scoring?
No. It is one signal — strong, but one signal. Combine with your product logic (lead source, origin page, time, etc.) for the final decision. Our verdict is a recommendation, not a commercial decision.
Does it support bulk?
Public bulk verifies emails. To process full leads with multiple channels in batch, today the recommended path is calling /lead/verify from your backend with your own concurrency. For >50k monthly, contact us.
Try it with 500 free credits
No credit card. Start using the API as soon as you sign up.
Create account