01 · VALIDADORES
Cada validador faz uma coisa. Escolha um ou use Smart Parse para roteamento automático.
| Validador | Endpoint | O que valida | Quando usar |
|---|---|---|---|
| Smart Parse | POST /v1/verify | Qualquer string crua — detecta tipo e país | Quando você não sabe o que o usuário enviou |
| Person | POST /v1/verify/person | Nomes com sobrenome paterno e materno, data, gênero, nacionalidade | Quando recebe nomes LATAM em formato livre |
| Tax ID | POST /v1/verify/tax-id | CUIT, CUIL, CPF, CNPJ, RFC, RUT, RIF, NIT, RUC e mais | Quando você já sabe o país e o tipo de tax ID |
| Contact | POST /v1/verify/contact | Email (sintaxe + MX) e telefone (E.164 + país) | Quando coleta email ou telefone em um formulário |
| Bank | POST /v1/verify/bank | CBU, CVU, CLABE, IBAN — checksum e bank lookup | Antes de um payout ou uma transferência |
| Address | POST /v1/verify/address | Endereços LATAM com parsing sintático de componentes | Quando recebe endereços como string de texto livre |
POST /v1/verifyO QUE FAZ
Recebe um string sem tipo e roteia para o validador correto entre 17 identificadores em 10 países. Devolve detected_type, confidence e os candidatos rankeados com seu score.
O QUE NÃO FAZ
Não verifica se a entidade está registrada na AFIP, Receita Federal ou SAT. Não substitui um endpoint específico quando você já sabe o tipo — rode direto o validador targetted.
POST /v1/verify/personO QUE FAZ
Divide nomes hispanos e brasileiros em first / paterno / materno. Corrige maiúsculas e acentos quando é determinístico. Resolve gentílicos e nacionalidades contra uma tabela LATAM.
O QUE NÃO FAZ
Não verifica se a pessoa existe no RENIEC, AFIP ou Receita. Não faz verificação de identidade — isso é KYC, uma camada diferente que roda depois da validação de formato.
POST /v1/verify/tax-idO QUE FAZ
Implementa o checksum correto por país: Mod-11 com pesos custom (CUIT), duas rodadas seguidas de Mod-11 (CPF, CNPJ), homoclave alfanumérica do SAT (RFC), Mod-11 da direita para a esquerda com K como dígito (RUT-CL).
O QUE NÃO FAZ
Não consulta AFIP, Receita Federal nem SAT. Um resultado válido significa que o formato e o dígito verificador estão corretos — não que o contribuinte esteja ativo, registrado ou em dia com o fisco.
POST /v1/verify/contactO QUE FAZ
Valida sintaxe de email, resolve typos comuns (gmial → gmail) e opcionalmente verifica MX. Normaliza telefones para E.164, detecta país e tipo (móvel / fixo).
O QUE NÃO FAZ
Não verifica que a caixa de email realmente existe nem envia um código de confirmação. Não liga para uma operadora para confirmar que o número está ativo.
POST /v1/verify/bankO QUE FAZ
Valida quatro formatos: CBU (Mod-10 por bloco), CVU (mesmo checksum, prefixo distinto), CLABE (dígito ponderado Banxico), IBAN (Mod-97-10). Resolve bank_code → bank_name a partir de registros oficiais (BCRA, Banxico).
O QUE NÃO FAZ
Não verifica se a conta está aberta nem quem é o titular. Não executa uma transferência de teste — só valida que o número está bem formado e pertence a um banco real.
POST /v1/verify/addressO QUE FAZ
Extrai componentes (rua, número, andar, apto, localidade, estado, país) de um string. Normaliza o estado para ISO 3166-2. Mapeia variantes ("Bs As", "BUENOS AIRES") para o nome canônico.
O QUE NÃO FAZ
Não geocodifica — não devolve lat/lng nem chama Google Maps. Não verifica que o endereço existe fisicamente. O parsing é sintático, não semântico.
Cinco perguntas para rotear seu caso ao endpoint certo sem testar todos.
Não. Uma única key (header X-API-Key) habilita os seis validadores. Os rate limits se aplicam ao total de requests, não por endpoint.
Não. Smart Parse roda o input contra as regras dos seis validadores em paralelo e devolve os candidatos rankeados. Não soma latência nem custo em relação a chamar o endpoint targetted quando você já sabe o tipo.
Ainda não. Durante o acesso antecipado os endpoints são de item único. Se precisar de processamento em massa, mencione no formulário do waitlist e a gente discute antes de emitir sua key.
Grátis durante o beta. Respondemos por email em 24 horas ou antes.