Códigos de Retorno

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

Code / Responses

200 OK

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

400 Requisição inválida

• O número de CNPJ 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://apigateway.serpro.gov.br/consulta-cnpj-df/v1/cnpj/{ni}"

404 Não Encontrado

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

422 Entidade não processada

• Consulta não realizada - não foi possível recuperar o histórico de eventos.

500 Erro no servidor

• Ocorreu algum erro interno no Servidor.

502 Erro de Integração

• Ocorreu algum erro de integração que impossibilitou que esta requisição de consulta da API obtivesse os dados solicitados. Não foi possível recuperar o histórico de eventos.

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 DUE.