Consultar processo administrativo por NUP
GET/v1/processos/administrativos/nup/:nup
Consulta um processo administrativo pelo NUP nas fontes oficiais. fonte=AUTO roteia NUPs iniciados por 02001 para o SEI/IBAMA e os demais para o Protocolo Integrado. A resposta inclui capa, movimentações e, quando a origem publicar, o índice de documentos. Não encontrado ou indisponibilidade temporária da fonte não geram débito.
Valor para a operação: traz capa e tramitações oficiais de um NUP para o mesmo fluxo técnico já usado nos processos judiciais.
Autenticação e resposta: envie a chave em x-api-key ou Authorization: Bearer. Os exemplos mostram uma resposta típica; campos adicionais podem aparecer conforme o tipo de consulta. meta pode conter creditsCharged, creditsRemaining, requestId e searchLogId. Trate erros pelo status HTTP e por error.code.
SLA e HTTP 202: a API reserva uma janela total de até 30 segundos para responder. Quando uma consulta elegível não termina com segurança nessa janela, o trabalho continua no servidor e a resposta é HTTP 202, sem débito adicional naquele estado pendente. Siga o header Location ou data.statusUrl com a mesma API key; Retry-After, pollAfterSeconds, pollAfterMs e nextPollAt informam quando tentar novamente. Pare o polling quando receber um status diferente de 202. A URL de status reproduz a resposta final sem executar nem cobrar a operação novamente. O fluxo pode retornar uma solicitação pendente; consulte a URL/status retornado quando fornecido.
Requisição
Responses
- 200
- 202
- 400
- 401
- 403
- 404
- 422
- 429
- 500
Resposta da operação.
Solicitação aceita para processamento assíncrono.
JSON inválido ou parâmetros ausentes/inválidos.
API key ausente ou inválida.
Conta inativa, saldo insuficiente ou operação não permitida.
Recurso não encontrado.
Parâmetros válidos sintaticamente, mas rejeitados por regra de negócio.
Limite de requisições excedido. A API aplica limites por classe de rota.
Erro interno não especificado.