Portal do Desenvolvedor

Localize — dados cadastrais e de contato via API

Obtenha informações de pessoas físicas e jurídicas a partir de CPF, CNPJ, e-mail, telefone ou nome/endereço. Ideal para confirmação de identidade, higienização e enriquecimento de bases e localização de contatos.

Todas as requisições usam a URL base https://api.assertivasolucoes.com.br e exigem um token OAuth2 no cabeçalho Authorization: Bearer.

O que dá para fazer

Consultas principais

Retornam os dados cadastrais e de contato a partir de um identificador:

Consulta	Endpoint	Entrada principal
Por CPF	`GET /localize/v3/cpf`	`cpf`
Por CNPJ	`GET /localize/v3/cnpj`	`cnpj`
Por e-mail	`GET /localize/v3/email`	`email`
Por telefone	`GET /localize/v3/telefone`	`telefone`
Por nome ou endereço	`GET /localize/v3/nome-endereco`	`buscarPor` + `nomeOuRazaoSocial` ou `cepOuNomeRua`

Consultas de conexões

Podem ser chamadas diretamente a partir de um documento (CPF ou CNPJ), sem precisar de uma consulta principal anterior.

Conexões

Pessoas, empresas e telefones vinculados (parentes, cônjuge, sócios, empregador, decisores). Recebe documento, tipo e idFinalidade. GET /localize-api/v1/base-cadastral/conexoes

Pessoas de referência

Mãe, filhos, irmãos e sócios de um CPF, úteis para confirmar identidade. Recebe cpf e idFinalidade; o protocolo de uma consulta anterior é opcional. GET /localize/v3/pessoas-de-referencia

Consultas secundárias

Aprofundam uma consulta principal já realizada e exigem o protocolo retornado no cabeçalho dela.

Mais telefones

Telefones relacionados a um CPF ou CNPJ. Exige o protocolo de uma consulta de CPF ou CNPJ com o mesmo documento. GET /localize/v3/mais-telefones

Possíveis decisores

Tomadores de decisão de um CNPJ. Exige o protocolo de uma consulta de CNPJ com o mesmo documento. GET /localize/v3/possiveis-decisores

Complementos e relatórios

Feedbacks de telefone (/feedback/v3/telefone): avalie se um telefone é válido para um documento já consultado.
Meu Portal (/meu-portal/v3/...): adicione comentários, e-mails, endereços e telefones a documentos já consultados.
Relatórios (/localize/v3/report/usage e /ultimas-consultas/v3): acompanhe as consultas realizadas.

Escolha da consulta

Quando usar cada consulta principal

CPF

CPF / CNPJ

Quando você já tem o documento e quer os dados cadastrais completos.

E-mail / Telefone

Quando você tem apenas um contato e quer descobrir a quais pessoas ou empresas ele está vinculado.

A-Z

Nome ou endereço

Quando você não tem documento nem contato, apenas nome e/ou localização.

Conformidade

Finalidade de uso (LGPD)

A maioria das consultas exige o parâmetro obrigatório idFinalidade, que declara a base legal para o uso dos dados pessoais. Os valores aceitos, conforme a documentação da API, são:

`idFinalidade`	Finalidade
`1`	Confirmação de identidade
`2`	Ciclo de crédito
`5`	Legítimo interesse

Escolha a finalidade que corresponde ao seu caso de uso real. Este parâmetro é parte do compromisso de conformidade com a LGPD.

Próximos passos

Continue a integração

Autenticação

Gere o token de acesso — pré-requisito de todas as chamadas.

Primeira requisição

Faça sua primeira consulta por CPF, passo a passo.

Casos de uso

Combine consultas em fluxos reais de negócio.