Códigos de Retorno

As requisições à API CPF podem retornar os seguintes código HTTP:

Códigos não bilhetados

Os seguintes códigos não serão bilhetados no faturamento: 400 (Requisição inválida), 401 (Não autorizado), 403 (Proibido), 500 (Erro no servidor) e 504 (Tempo Esgotado do Gateway).

Code / Responses

200 OK

Tudo funcionou como esperado e a validação dos dados foi realizada com sucesso.

206 Conteúdo Parcial

As informações foram retornadas, mas não completamente.

400 Requisição Inválida

O número de CPF informado não é válido.

401 Não Autorizado

Problemas durante a autenticação.

403 Proibido

Este erro ocorre quando há algum caminho errado na requisição. Certifique-se de chamar a API da seguinte forma: "https://gateway.apiserpro.serpro.gov.br/consulta-cpf-df/v1/cpf/{ni}"

404 Não Encontrado

Não existe CPF com o número de inscrição informado.

422 LGPD: Dados de Menor de Idade

Dados de menor de idade bloqueados em atendimento à Lei Geral de Proteção de Dados - LGPD. A Lei Geral de Proteção de Dados Pessoais (LGPD), Lei Nº 13.709, de 14 de agosto de 2018, dispõe sobre o tratamento de dados pessoais, inclusive nos meios digitais, por pessoa natural ou por pessoa jurídica de direito público ou privado, com o objetivo de proteger os direitos fundamentais de liberdade e de privacidade e o livre desenvolvimento da personalidade da pessoa natural. Para proteger os direitos fundamentais de liberdade e privacidade e o livre desenvolvimento da personalidade da pessoa natural foi criada a Autoridade Nacional de Proteção de Dados (ANPD), conforme estabelecido no Decreto Nº 10.474, de 26 de agosto de 2020.

500 Erro no Servidor

Ocorreu algum erro interno no Servidor.

504 Tempo Esgotado do Gateway

Ocorreu algum erro de rede e o gateway não respondeu a tempo. A requisição não chegou até a API Consulta CPF.