Erros & status

Códigos HTTP, status da verificação e motivos de recusa.

Códigos HTTP

200 OK

Requisição processada.

400 Bad Request

JSON inválido ou campo fora do formato esperado.

401 Unauthorized

Chave ausente, inválida ou revogada.

404 Not Found

Candidato inexistente ou de outro workspace.

413 Payload Too Large

Imagem acima de 10 MB.

500 Internal Error

Falha inesperada — repita com backoff exponencial.

{ "error": "Invalid API key" }

Status da verificação

created

candidato criado, aguardando envio

processing

IA analisando documentos

pending

aguardando revisão manual

approved

verificação aprovada

rejected

verificação recusada (veja reason)

Motivos de recusa

// applicant.reason acumula os motivos da decisão
"CPF inválido."
"CPF não localizado na base oficial."
"Nome divergente da base oficial de CPF."
"Selfie não corresponde à foto do documento; documento com sinais de edição."

Repita apenas erros 5xx, com backoff exponencial. Erros 4xx indicam problema na requisição e não se resolvem com retentativa.