01 · VALIDADORES

Validadores core para datos operacionales LATAM

Cada validador hace una cosa, en lote. Validá por campo o mandá el registro completo a Records.

Comparativa de los endpoints core

ValidadorEndpointQué validaCuándo usarlo
Tax IDsPOST /v1/validate/tax-idsDNI, CUIT, CUIL, CPF, CNPJ, RFC, CURP, RUT, NIT, RUC, Cédula y másCuando validás documentos fiscales en lote, sabiendo el país
CuentasPOST /v1/validate/accountsCBU, CVU, CLABE, CCI, IBAN — checksum + nombre de bancoAntes de un payout o transferencia, en lote
EmailsPOST /v1/validate/emailsSintaxis RFC + normalización + detección de typos de dominioCuando validás emails en lote antes de guardarlos
TeléfonosPOST /v1/validate/phonesNormalización a E.164 + tipo de línea (móvil/fijo)Cuando validás teléfonos en lote, sabiendo el país
RecordsPOST /v1/validate/recordsEntidad completa: documento + cuenta + nombre + email + teléfono + dirección, con consistencia y readinessCuando validás registros completos (proveedores, clientes) antes de operar
PersonasPOST /v1/validate/recordsNombres con apellido paterno y materno, género, nacionalidadCuando un record incluye el nombre de una persona
DireccionesPOST /v1/validate/recordsDomicilios LATAM con parseo de componentes y estado ISO 3166-2Cuando un record incluye un domicilio en texto libre
DominiosPOST /v1/validate/emailsSintaxis del dominio + detección de typos contra proveedores comunesCuando validás la parte de dominio de un email antes de guardarlo

Detalle por validador

Tax IDs

POST /v1/validate/tax-ids

QUÉ HACE

Implementa el checksum correcto por país: Mod-11 con pesos custom (CUIT), dos rondas de Mod-11 (CPF, CNPJ), homoclave del SAT (RFC), Mod-11 con K verificador (RUT-CL). Cubre identificaciones personales (DNI, CURP, Cédula) y fiscales. Mandás un lote de hasta 1.000 ítems y recibís un resultado por ítem.

QUÉ NO HACE

No consulta AFIP, Receita Federal ni SAT. Un resultado válido significa que el formato y el dígito verificador son correctos — no que el contribuyente esté activo o registrado.

Cuentas

POST /v1/validate/accounts

QUÉ HACE

Valida formatos bancarios: CBU (Mod-10 por bloque), CVU (mismo checksum, prefijo distinto), CLABE (dígito ponderado de Banxico), CCI (Perú), IBAN (Mod-97-10). Resuelve bank_code → bank_name desde registros oficiales. Hasta 1.000 cuentas por request.

QUÉ NO HACE

No verifica que la cuenta esté abierta ni quién es el titular. No ejecuta una transferencia de prueba — solo valida que el número está bien formado y pertenece a un banco real.

Emails

POST /v1/validate/emails

QUÉ HACE

Valida sintaxis de email según RFC, normaliza (lowercase, trim) y detecta typos de dominio contra proveedores comunes (gmial → gmail). Mandás un lote de hasta 1.000 emails y recibís validez y forma normalizada por ítem.

QUÉ NO HACE

No verifica que el inbox exista ni hace lookup SMTP. Valida que el email esté bien armado, no que reciba correo.

Teléfonos

POST /v1/validate/phones

QUÉ HACE

Parsea teléfonos en cualquier formato y devuelve E.164, validez y tipo de línea (mobile, landline, mobile_or_landline, other). El país es la región de parseo. Hasta 1.000 teléfonos por request.

QUÉ NO HACE

No llama a la operadora ni envía SMS de prueba. Valida que el número esté bien formado para el país, no que esté activo.

Records

POST /v1/validate/records

QUÉ HACE

Valida una entidad completa en una request: cada campo presente se valida con su normalizador, se chequea consistencia entre campos (país↔documento, país↔cuenta) y se calcula readiness por proceso: payment (listo para pagar) y billing (listo para facturar). Hasta 500 records por request.

QUÉ NO HACE

No es KYC ni verificación de identidad. No consulta registros gubernamentales. Confirma que el registro esté bien armado y sea internamente consistente, no que la entidad exista.

Personas

POST /v1/validate/records

QUÉ HACE

Splittea nombres hispanos y brasileños en first / paterno / materno. Corrige mayúsculas y acentos cuando es determinístico. Resuelve gentilicios y nacionalidades contra una tabla LATAM. Viaja como campo name dentro de /v1/validate/records.

QUÉ NO HACE

No verifica que la persona exista en RENIEC, AFIP o RNCN. No hace verificación de identidad — eso es KYC, una capa distinta que corre después de la validación de formato.

Direcciones

POST /v1/validate/records

QUÉ HACE

Extrae componentes (calle, número, piso, depto, localidad, estado, país) de un string. Normaliza el estado a ISO 3166-2. Mapea variantes ("Bs As", "BUENOS AIRES") al nombre canónico. Viaja como campo address dentro de /v1/validate/records.

QUÉ NO HACE

No geocodifica — no devuelve lat/lng ni llama a Google Maps. No verifica que el domicilio exista físicamente. El parseo es sintáctico, no semántico.

Dominios

POST /v1/validate/emails

QUÉ HACE

La validación de dominio vive dentro de /v1/validate/emails: chequea que la parte después de la @ tenga sintaxis válida y detecta typos contra proveedores comunes (gmial.com → gmail.com). No es un endpoint aparte — es parte del check de email.

QUÉ NO HACE

No resuelve registros DNS ni MX, ni verifica que el dominio reciba correo. Valida que el dominio esté bien escrito, no que exista o esté activo.

¿Cómo elegir el validador correcto?

Cinco preguntas para rutear tu caso al endpoint correcto sin probar todos.

  • ¿Validás documentos fiscales?Usá Tax IDs con country y type por ítem. Checksum por país, hasta 1.000 ítems por request.
  • ¿Vas a mandar plata a esa cuenta?Validá con Cuentas antes del intento de pago. Atrapa errores de tipeo en CBU, CVU, CLABE, CCI o IBAN antes de que la transferencia vuelva rebotada.
  • ¿Estás guardando emails o teléfonos?Usá Emails o Teléfonos. Sintaxis RFC y typos de dominio; E.164 y tipo de línea. En lote.
  • ¿Necesitás el registro completo?Usá Records. Validás tax_id, cuenta, nombre, email, teléfono y dirección de una entidad, con consistencia y readiness (payment, billing).
  • ¿Tenés más de 1.000 ítems?Paginá. El mismo endpoint valida 1 o N hasta el tope por request (1.000 piezas, 500 records); dividí el dataset en lotes.

Preguntas frecuentes

¿Necesito una API key por endpoint?

No. Una sola key (header X-API-Key) te habilita los cinco endpoints de la API. Los rate limits se aplican al total de requests, no por endpoint.

¿Cómo correlaciono cada resultado con su input?

Cada ítem lleva un id (o reference_id en records) que vos proveés; se devuelve verbatim en el result correspondiente. El orden del array results también sigue al de items.

¿Hay un endpoint batch?

Sí — todos lo son. Mandás un array items y recibís un results por ítem (hasta 1.000 piezas, 500 records). El mismo endpoint sirve para 1 o N.

Pedí acceso anticipado

Gratis durante la beta. Respondemos por email en 24 horas o antes.