Pular para o conteúdo principal

Consultar capa de processo por CNJ

GET 

/v1/processos/cnj/:cnj

Obtém a capa/dados principais de um processo por seu número CNJ. O número é normalizado e validado; use esta operação depois de identificar o processo e antes de solicitar movimentações, documentos públicos ou resumo por IA. Use data.valor_causa como atalho estável; data.fontes[0].capa.valor_causa permanece compatível. Quando o valor ainda não estiver no cache, a resposta permanece rápida e o enriquecimento é agendado em segundo plano. A resposta segue o envelope data/meta e pode indicar saldo e requestId.

Valor para a operação: consolida a visão principal do processo para abastecer telas, cadastros, análises e decisões sobre os próximos dados a consultar.

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.

Requisição​

Responses​

Resposta da operação.