Consulta CPF — E-mails
Last updated
Retorna e-mails vinculados ao CPF, em minúsculas, sem duplicidade e organizados por prioridade.
| Propriedade | Valor |
|---|---|
| Dataset | cpf_emails |
| Método e caminho | POST /datasets/cpf_emails/queries |
Versão do schema de dados (schema_version) |
1.0.0 |
| Entrada | CPF |
| Consultas em lote | Suportadas, conforme disponibilidade no catálogo |
Requisição
curl --request POST 'https://api.verifica-online.com.br/datasets/cpf_emails/queries' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: exemplo-cpf-emails-001' \
--data '{"cpf":"52998224725"}'
{
"cpf": "52998224725"
}
| Campo | Tipo | Obrigatório | Regras |
|---|---|---|---|
cpf |
string |
Sim | Exatamente 11 dígitos, sem pontuação ou espaços, com dígitos verificadores válidos. Sequências de um único dígito repetido são rejeitadas. |
O corpo aceita somente cpf; campos adicionais e CPF numérico são rejeitados. Não são aceitos parâmetros de consulta na URL. Validar os dígitos não comprova existência, identidade ou titularidade do documento.
Veja autenticação e requisições, idempotência e cobrança.
Exemplo de data
O CPF é didático e o endereço de e-mail usa o domínio reservado example.com. O exemplo é sintético, não representa uma resposta garantida nem comprova titularidade ou entrega de mensagens. Os campos externos a data estão descritos em resultados.
{
"cpf": "52998224725",
"total": 1,
"emails": [
{
"email": "contato@example.com",
"domain": "example.com",
"username": "contato",
"type": "personal",
"priority": 1,
"similarity": 95.5,
"quality": null
}
]
}
Contrato de data
data é um objeto ou null. Quando há dados, todas as propriedades abaixo estão presentes e não há propriedades adicionais.
| Campo | Tipo | Descrição e limites |
|---|---|---|
cpf |
string |
CPF consultado, com 11 dígitos sem pontuação. |
total |
integer |
Quantidade de e-mails retornados após seleção e remoção de duplicidades; igual a emails.length. |
emails |
array<object> |
Lista de até 1.000 e-mails. Em um resultado com dados, contém pelo menos um item. |
emails[].email |
string |
Endereço completo em minúsculas. |
emails[].domain |
string |
Parte do endereço após @, em minúsculas. |
emails[].username |
string |
Parte do endereço antes de @, em minúsculas. |
emails[].type |
string |
personal, business ou unknown, conforme classificação reconhecida. |
emails[].priority |
integer ou null |
Prioridade informada; pode ser negativa. null indica ausência ou valor não aproveitável. |
emails[].similarity |
number ou null |
Indicador de similaridade informado, entre 0 e 100. Não deve ser interpretado como prova de titularidade ou garantia de precisão. |
emails[].quality |
boolean ou null |
Indicador de qualidade reconhecido: true, false ou null quando desconhecido. Não comprova que a caixa postal está ativa. |
Os endereços retornados não contêm espaços nem caracteres de controle. Possuem usuário e domínio não vazios, um @ e ponto no domínio. A consulta não confirma entrega de mensagens nem existência da caixa postal.
A lista contém endereços completos únicos em minúsculas, ordenados por prioridade crescente. Ausência de prioridade é tratada como o menor nível de prioridade; a ordem entre itens de mesma prioridade não é garantida.
Ausência de dados e cobrança
Ausência reconhecida de e-mails produz status: "no_data" e data: null, sem cobrança. Uma lista não vazia sem nenhuma entrada aproveitável, uma resposta incoerente ou acima do limite de itens resulta em erro, sem cobrança.
Em uma consulta comum com status: "succeeded", aplica-se o preço efetivo da conta. Consulte GET /datasets para disponibilidade, schema e preço vigentes, e billing para a cobrança da operação. Veja resultados e erros.
Consultas em lote
O dataset aceita POST /datasets/cpf_emails/batches quando batch.enabled estiver habilitado no catálogo. Cada CPF usa este mesmo contrato. Veja consultas em lote para limites, validação por entrada, reserva, cobrança consolidada, recuperação e webhook.