01 · VALIDADORES
Cada validador hace una cosa. Elegí uno o usá Smart Parse para auto-rutear.
| Validador | Endpoint | Qué valida | Cuándo usarlo |
|---|---|---|---|
| Smart Parse | POST /v1/verify | Cualquier string crudo — detecta tipo y país | Cuando no sabés qué te mandó el usuario |
| Person | POST /v1/verify/person | Nombres con apellido paterno y materno, fecha, género, nacionalidad | Cuando recibís nombres LATAM en formato libre |
| Tax ID | POST /v1/verify/tax-id | CUIT, CUIL, CPF, CNPJ, RFC, RUT, RIF, NIT, RUC y más | Cuando ya sabés el país y el tipo de tax ID |
| Contact | POST /v1/verify/contact | Email (sintaxis + MX) y teléfono (E.164 + país) | Cuando recolectás email o teléfono en un formulario |
| Bank | POST /v1/verify/bank | CBU, CVU, CLABE, IBAN — checksum y bank lookup | Antes de un payout o una transferencia |
| Address | POST /v1/verify/address | Domicilios LATAM con parseo sintáctico de componentes | Cuando recibís domicilios como string de texto libre |
POST /v1/verifyQUÉ HACE
Recibe un string sin tipar y lo rutea al validador correcto entre 17 identificadores en 10 países. Devuelve detected_type, confidence y los candidatos rankeados con su score.
QUÉ NO HACE
No verifica que la entidad esté registrada en AFIP, Receita Federal o SAT. No reemplaza un endpoint específico cuando ya sabés el tipo — corré directo el validador targetted.
POST /v1/verify/personQUÉ 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.
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.
POST /v1/verify/tax-idQUÉ HACE
Implementa el checksum correcto por país: Mod-11 con pesos custom (CUIT), dos rondas seguidas de Mod-11 (CPF, CNPJ), homoclave alfanumérica del SAT (RFC), Mod-11 derecha a izquierda con K como verificador (RUT-CL).
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, registrado o en regla con el fisco.
POST /v1/verify/contactQUÉ HACE
Valida sintaxis de email, resuelve typos comunes (gmial → gmail) y opcionalmente verifica MX. Normaliza teléfonos a E.164, detecta país y tipo (móvil / fijo).
QUÉ NO HACE
No verifica que el inbox de email realmente exista ni envía un código de confirmación. No llama a una operadora para confirmar que el número está activo.
POST /v1/verify/bankQUÉ HACE
Valida cuatro formatos: CBU (Mod-10 por bloque), CVU (mismo checksum, prefijo distinto), CLABE (dígito ponderado de Banxico), IBAN (Mod-97-10). Resuelve bank_code → bank_name desde registros oficiales (BCRA, Banxico).
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.
POST /v1/verify/addressQUÉ 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.
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.
Cinco preguntas para rutear tu caso al endpoint correcto sin probar todos.
No. Una sola key (header X-API-Key) te habilita los seis validadores. Los rate limits se aplican al total de requests, no por endpoint.
No. Smart Parse corre el input por las reglas de los seis validadores en paralelo y devuelve los candidatos rankeados. No suma latencia ni costo respecto de llamar al endpoint targetted cuando ya sabés el tipo.
Todavía no. Durante acceso anticipado los endpoints son de un solo item. Si necesitás procesamiento masivo, mencionalo en el formulario de waitlist y lo discutimos antes de emitir tu key.
Gratis durante la beta. Respondemos por email en 24 horas o antes.