API Identity: vínculo entre e-mail e CPF

Avalia o vínculo entre um e-mail e um CPF e devolve nota, decisão sugerida e os motivos. Não devolve dados cadastrais. Seis créditos por análise respondida.

Antes da primeira consulta, a conta precisa declarar no portal para que vai usar o Identity e aceitar os termos. É uma única vez, na tela do Identity. Sem isso, a API responde 403 purpose_required e nada é cobrado.

Analisar

POST/v1/identity

Síncrono: a resposta chega em 1 a 2 segundos.

Campo	Tipo	Descrição
`email`	texto	Obrigatório. O e-mail informado no cadastro.
`cpf`	texto	Opcional. CPF do titular, com ou sem pontuação. Sem ele, a análise considera só o e-mail.

curl -X POST https://gateway.autentify.com.br/v1/identity \
  -H "Authorization: Bearer $AUTENTIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"ana@empresa.com.br","cpf":"123.456.789-09"}'

Resposta (200)

{
  "id": "idn_4e8a1d3c96b07f25c8d4e1a9",
  "email": "ana@empresa.com.br",
  "cpf": "***.456.789-**",
  "checked_at": "2026-10-03T14:31:09.118204Z",
  "score": 842,
  "decision": "allow",
  "risk": "low",
  "reasons": [],
  "strengths": [
    "email_linked_to_cpf",
    "long_digital_presence",
    "email_deliverable"
  ],
  "subscores": {
    "identity_link": 90,
    "email_quality": 95,
    "history_network": 78
  },
  "evidence_level": "high",
  "sources": {
    "registry": "ok",
    "history": "ok",
    "email_validation": "ok",
    "breach_exposure": "ok"
  },
  "signals": {
    "email_linked_to_cpf": "confirmed",
    "email_matches_holder_name": "high",
    "cpf_recent_market_queries": "low",
    "email_age_years": "over_5",
    "email_format_risk": "low",
    "email_known_to_autentify": "known",
    "email_recent_queries": "low",
    "emails_per_cpf": "one",
    "email_deliverable": "yes",
    "email_possible_typo": "no",
    "email_cpf_pair_history": "recurring",
    "chargeback_network_risk": "none"
  },
  "engine_version": "identity_rules_v4.1.0"
}

Resultado

Campo	Descrição
`id`	Identificador da análise.
`email`	O e-mail analisado, em minúsculas.
`cpf`	O CPF mascarado, ou null quando não foi informado.
`checked_at`	Data e hora da análise, em UTC (ISO 8601).
`score`	Nota de 0 a 1000. Quanto maior, maior a confiança no vínculo entre o e-mail e o CPF.
`decision`	Decisão sugerida (tabela abaixo). Quem decide é você.
`risk`	Faixa de risco: low, medium ou high.
`reasons`	Até 4 códigos do que pesou contra.
`strengths`	Até 3 códigos do que pesou a favor.
`subscores`	Notas de 0 a 100 por dimensão: identity_link (vínculo), email_quality (qualidade do e-mail) e history_network (histórico e rede).
`evidence_level`	Quanta evidência sustentou a análise: high, medium ou low.
`sources`	Estado de cada fonte consultada.
`signals`	Sinais observados, em códigos (tabela abaixo).
`engine_version`	Versão das regras que produziram a análise.

Tudo vem em códigos estáveis, para você traduzir e aplicar suas regras. Códigos novos podem ser acrescentados: trate um código desconhecido sem falhar.

Decisão

decision	Sugestão
`allow`	Aprovar.
`step_up`	Pedir uma verificação adicional (por exemplo, confirmar o e-mail ou um documento).
`manual_review`	Encaminhar para revisão manual.
`reject`	Recusar.

Fontes

sources traz registry (fonte cadastral), history (histórico), email_validation (validação do e-mail) e breach_exposure (vazamentos), cada uma com ok ou not_applicable. Sem CPF, as fontes que dependem dele vêm como not_applicable, e os sinais ligados ao CPF também. Uma análise só é devolvida (e cobrada) quando todas as fontes aplicáveis respondem.

Motivos contra (reasons)

Código	Significado
`registry_deceased`	A fonte cadastral informa óbito do titular do CPF.
`registry_null`	CPF com situação nula.
`registry_cancelled`	CPF cancelado.
`registry_suspended`	CPF suspenso.
`registry_unrecognized`	Situação cadastral não reconhecida.
`cpf_not_found`	CPF não localizado na fonte cadastral.
`email_not_linked_to_cpf`	E-mail não associado ao CPF na fonte cadastral.
`email_unrelated_to_holder`	E-mail sem relação aparente com o nome do titular.
`email_disposable`	E-mail de domínio temporário.
`email_not_receiving`	O endereço não recebe mensagens.
`email_deliverability_inconclusive`	Validação do e-mail não conclusiva.
`email_possible_typo`	Possível erro de digitação no e-mail.
`email_pattern_unusual`	Padrão incomum no endereço de e-mail.
`no_digital_presence`	E-mail sem histórico de presença digital.
`recent_digital_presence`	E-mail com presença digital recente.
`email_new_to_autentify`	E-mail visto pela primeira vez na base Autentify há menos de 30 dias.
`email_burst`	E-mail consultado várias vezes nos últimos 30 dias.
`cpf_many_emails`	CPF associado a vários e-mails na base Autentify.
`cpf_frequently_queried`	CPF consultado com frequência no mercado nos últimos 12 meses.
`email_chargeback_reported`	Histórico de risco associado ao e-mail na rede Autentify.
`near_reported_chargeback`	Ligação com risco na rede Autentify.
`other_risk_signal`	Outro sinal de risco.

Motivos a favor (strengths)

Código	Significado
`email_linked_to_cpf`	E-mail associado ao CPF na fonte cadastral.
`email_matches_holder`	E-mail compatível com o nome do titular.
`long_digital_presence`	E-mail com presença digital de longa data.
`email_known_to_autentify`	E-mail conhecido há mais de um ano na base Autentify.
`pair_established`	CPF e e-mail com histórico estabelecido na base Autentify.
`pair_recurring`	CPF e e-mail vistos juntos em mais de uma ocasião.
`email_deliverable`	E-mail válido e apto a receber mensagens.

Sinais (signals)

Sinal	O que mede	Valores
`email_linked_to_cpf`	E-mail vinculado ao CPF	confirmed, similar, not_confirmed, no_data
`email_matches_holder_name`	E-mail combina com o nome do titular	high, medium, low
`cpf_recent_market_queries`	Consultas ao CPF no mercado (12 meses)	low, medium, high
`email_age_years`	Idade da presença digital do e-mail	no_history, under_2, 2_to_5, over_5
`email_format_risk`	Risco do padrão do endereço	low, medium, high
`email_known_to_autentify`	E-mail na base Autentify	new, recent, known, long_known
`email_recent_queries`	Consultas ao e-mail (30 dias)	none, low, medium, high
`emails_per_cpf`	E-mails vistos com o CPF	none, one, two, three_or_more
`email_deliverable`	E-mail recebe mensagens	yes, uncertain, no
`email_possible_typo`	Possível erro de digitação	no, yes
`email_cpf_pair_history`	Histórico do par CPF e e-mail	new, seen_once, recurring, established
`chargeback_network_risk`	Risco na rede Autentify	none, elevated, high

Qualquer sinal também pode vir como not_applicable ou unavailable.

CPF e privacidade

O CPF é validado antes da consulta e só vai ao motor quando você informa. A Autentify guarda apenas o CPF mascarado (***.456.789-**), para você reconhecer a análise no histórico. A resposta nunca traz nome, endereço ou qualquer dado cadastral do titular: só nota, decisão e códigos.

Cobrança e erros

Cada análise respondida custa 6 créditos. Além dos erros comuns, nenhum destes é cobrado:

HTTP	code	Quando acontece
`422`	`invalid_email`	E-mail com formato inválido.
`403`	`purpose_required`	A conta ainda não declarou a finalidade de uso no portal.
`422`	`invalid_cpf`	CPF inválido.
`422`	`invalid_input`	O motor recusou os dados enviados.
`503`	`module_unavailable`	O Identity ou uma de suas fontes está indisponível. Tente de novo em alguns minutos.
`503`	`provider_timeout`	O motor demorou demais.

O Identity não tem lote na API: faça uma chamada por análise.