API Score: nota de risco do e-mail

Uma nota de 0 a 1000 para o risco de um e-mail, usada em cadastro, crédito e antifraude. Oito créditos por consulta respondida.

Consultar a nota

POST/v1/score

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

Campo	Tipo	Descrição
`email`	texto	Obrigatório. O e-mail a avaliar.
`cpf`	texto	Opcional. CPF do titular do e-mail, com ou sem pontuação.

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

Resposta (200)

{
  "id": "sc_c72e19b45d0a86f3e9b1247d",
  "email": "ana@empresa.com.br",
  "cpf_informed": false,
  "checked_at": "2026-10-03T14:20:45.310772Z",
  "score": 715,
  "risk": "low",
  "description": "E-mail com histórico consistente",
  "engine_version": "autentimail-v1"
}

Resultado

Campo	Descrição
`id`	Identificador da consulta.
`email`	O e-mail avaliado, em minúsculas.
`cpf_informed`	true quando a consulta foi feita com CPF.
`checked_at`	Data e hora da consulta, em UTC (ISO 8601).
`score`	Nota de 0 a 1000. Quanto maior, menor o risco: 1000 é risco baixíssimo.
`risk`	Faixa de risco: low, medium ou high.
`description`	Explicação curta do resultado, em português. Pode vir null.
`engine_version`	Versão do motor que calculou a nota.

Use risk para regras simples (aprovar, revisar, recusar) e score quando quiser definir seus próprios cortes.

CPF

O CPF é validado antes da consulta (11 dígitos e dígitos verificadores). Só é enviado ao motor quando você informa e não fica guardado na Autentify: registramos apenas que a consulta teve CPF (cpf_informed).

Cobrança e erros

Cada consulta respondida custa 8 créditos. Além dos erros comuns, nenhum destes é cobrado:

HTTP	code	Quando acontece
`422`	`invalid_email`	E-mail com formato inválido.
`422`	`invalid_cpf`	CPF inválido.
`422`	`invalid_input`	O motor recusou os dados enviados.
`503`	`module_unavailable`	O Score está indisponível. Tente de novo em alguns minutos.
`503`	`provider_timeout`	O motor demorou demais.

O Score não tem lote na API: faça uma chamada por e-mail, respeitando o limite de consultas por minuto.