Verificá un lead completo en una sola llamada
Mandás email, IP y teléfono (los que tengas); devolvemos un veredicto único, un puntaje general y el detalle por canal. Pagás solo los canales que mandás.
Qué incluye
Un solo request
Mandás email, IP y teléfono en el body; devolvemos todo junto, atómico desde tu lado.
Veredicto unificado
Accept / review / reject / unknown — una sola decisión para que tu lógica downstream sea simple.
Puntaje general ponderado
0-100 construido solo con los canales que mandaste. Más alto = más confiable.
Puntaje por canal
Si querés usar tu propia lógica de scoring, tenés los puntajes individuales de email, IP y teléfono.
Motivos listos para log
Lista de códigos legibles (email_block, ip_high_risk, phone_offline, etc.) para loguear y auditar decisiones.
Facturación por canal real
Si un canal falla no se cobra. Si una IP es privada no se cobra. Transparente en la respuesta.
Compatible con live line status
Si pedís live:true, el lead agrega el estado de la línea celular en tiempo real.
Detalle por canal
La respuesta agrupa el resultado de email, IP y teléfono junto con un veredicto general. Revisá el contrato de /api/v1/lead/verify para los campos de cada canal.
Cómo lo hacemos
Validamos los 3 canales en paralelo
Email, IP y teléfono se procesan concurrentemente para no sumar sus latencias.
Agregamos veredicto y puntaje
Reglas fijas combinan los resultados en un verdict (accept/review/reject/unknown) y un overall score ponderado.
Cobramos por canal real procesado
Lo que falla, no cobra. Lo que es inválido o fuera de scope, no cobra. Lo informamos campo por campo en la respuesta.
En código
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@empresa.com", "ip": "8.8.8.8", "phone": "+5491141235678", "default_country": "AR", "live": false }'
Preguntas frecuentes
¿Cuánto cuesta un lead combinado?
La suma de los canales que mandes. Email + IP + teléfono local = 3 créditos (1+1+1). Email + IP + teléfono con operador = 5 créditos (1+1+3). Si pedís línea en vivo también, sumá 6 créditos más.
¿Cómo se arma el veredicto único?
Combinamos los resultados por canal con reglas fijas. Si cualquier canal da "bloquear" el veredicto es "rechazar". Si alguno queda en revisión y ninguno es rechazo, va a "revisar". Si todos dan señal verde, "aceptar". Si ningún canal pudo resolverse, "sin señal".
¿Y el puntaje general?
Un promedio ponderado 0-100 solo de los canales que enviaste. No penaliza por los campos que no mandás: si solo mandás email y teléfono, el puntaje es el combinado de esos dos.
¿Qué información devuelve además del veredicto?
El detalle completo de cada canal, igual que si lo hubieras consultado solo. Email con su status y señales, IP con score y señales, teléfono con verdict y señales, línea en vivo si pediste. También los motivos del veredicto en una lista legible.
¿Puedo mandar solo algunos canales?
Sí. Mandás email, ip y/o phone en el body — los que falten no se validan ni se cobran. Útil cuando tu formulario solo captura algunos.
¿Qué pasa si un canal falla pero los otros no?
El canal que falló queda con "error" y los otros se entregan normalmente. No se cobra el canal que falló. El veredicto se calcula con los canales que sí resolvieron.
¿Esto me reemplaza el scoring interno?
No. Es una señal más — fuerte, pero una señal. Combinalo con tu lógica de producto (fuente del lead, página de origen, horario, etc.) para decidir final. Nuestro veredicto es una recomendación, no un veredicto comercial.
¿Soporta bulk?
El bulk público verifica emails. Para procesar leads completos en lote con varios canales, hoy la ruta recomendada es llamar a /lead/verify desde tu backend con tu propia concurrencia. Si tenés volumen >50k mensuales, escribinos.
Probalo con 500 créditos gratis
Sin tarjeta. Empezás a usar la API apenas creás la cuenta.
Crear cuenta