Pular para o conteúdo principal

Consultar mandados de prisão no BNMP

GET 
/v1/mandados

Consulta mandados de prisão por CPF ou número da peça na base BNMP/CNJ. Em uma resposta concluída, data.status é CONSTA quando a fonte retorna ao menos um mandado e NADA_CONSTA quando retorna zero registros. Falha, timeout ou indisponibilidade da fonte são retornados como erro e nunca como NADA_CONSTA. Ausência de mandado é um resultado válido e gera débito; indisponibilidade da fonte não gera débito. Se a consulta ultrapassar a janela síncrona, a API responde 202 e o trabalho continua no servidor. O resultado descreve os registros disponíveis naquele instante e não substitui certidão oficial.

Valor para a operação: traz mandados públicos do BNMP para triagem cadastral, compliance e due diligence, separados dos processos judiciais comuns.

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​

Resposta da operação.