Sign In

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.