Pular para o conteúdo principal

Listar processos de um advogado

GET 
/v1/advogados/processos

Lista processos encontrados pela infraestrutura própria com correspondência exata de número e UF da OAB. Os resultados são deduplicados por numeroCnj, ordenados pela última publicação e classificados como RECENTE ou HISTORICO. Essa classificação não equivale a processo ativo ou inativo confirmado pelo tribunal. A coleção é retornada em data.processos e também em data.items; a paginação usa page/limit e data.links.next.

Resultado progressivo: a resposta pode ser HTTP 200 com os processos já indexados enquanto a cobertura histórica oficial continua sendo ampliada em segundo plano. Quando data.cobertura.parcial for true, quantidadeProcessos, totalDisponivel, pagination.total e pagination.totalPages são provisórios e podem crescer em chamadas posteriores. Exiba o conteúdo como “atualizando histórico”, faça upsert por numeroCnj e não considere a paginação uma fotografia definitiva.

Importação completa: aguarde data.cobertura.completa === true, reinicie em page=1 e siga data.links.next.href até null. Persista data.cobertura.atualizadoEm como versão da coleta, deduplique por numeroCnj e reinicie ou reconcilie a varredura se atualizadoEm mudar entre páginas. Novas publicações oficiais ainda podem acrescentar ou reordenar processos em consultas futuras.

Cobrança: não faça polling curto da página 1. Cada nova chamada com page=1 é uma nova consulta e pode gerar cobrança; confira meta.creditsCharged. As páginas seguintes (page > 1) são incluídas sem cobrança adicional, mas só devem ser usadas em uma importação definitiva quando a cobertura estiver completa.

Valor para a operação: centraliza consultas relacionadas à atuação profissional e viabiliza carteiras, painéis e rotinas automatizadas por inscrição.

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.