Monitoramento
A API oferece três grupos principais de monitoramento.
Monitoramento transforma uma consulta pontual em acompanhamento contínuo. Sua equipe deixa de revisitar processos e termos apenas para descobrir se houve mudança; a integração passa a registrar o estado e entregar novidades ao fluxo operacional.
Impacto na produtividade
- automatiza a vigilância de processos selecionados;
- reduz conferências repetitivas em carteiras sem novidade;
- aciona tarefas, alertas ou atualizações quando um evento chega;
- permite acompanhar muitos casos com critérios consistentes;
- mantém a equipe concentrada na análise e na providência seguinte.
1. Monitoramento de processo (CNJ)
Acompanhe um processo específico.
Quando gera mais valor: carteiras ativas, casos prioritários, contencioso, cobrança e operações que precisam reagir a novas movimentações sem conferência manual diária.
| Método | Path | Descrição |
|---|---|---|
| GET | /v1/monitoramentos/processos | Listar |
| POST | /v1/monitoramentos/processos | Criar |
| GET | /v1/monitoramentos/processos/{id} | Consultar |
| DELETE | /v1/monitoramentos/processos/{id} | Remover/desativar |
Referências:
Frequência
O body de criação aceita frequência. Valores usados no produto:
DIARIASEMANALMENSAL
Enquanto ativo, o monitoramento gera cobrança recorrente conforme as regras de preço do endpoint.
2. Radar de novos processos
Localiza novos processos a partir de termo e filtros.
Quando gera mais valor: descoberta de novos casos, acompanhamento de empresas ou temas, prospecção jurídica responsável e enriquecimento de jornadas que começam antes de o número CNJ ser conhecido.
| Método | Path | Descrição |
|---|---|---|
| GET | /v1/monitoramentos/novos-processos | Listar radares |
| POST | /v1/monitoramentos/novos-processos | Criar radar |
| GET | /v1/monitoramentos/novos-processos/{id} | Consultar |
| DELETE | /v1/monitoramentos/novos-processos/{id} | Remover |
| GET | /v1/monitoramentos/novos-processos/{id}/resultados | Resultados |
| POST | /v1/monitoramentos/novos-processos/{id}/resultados/{numeroCnj}/qualificar | Qualificar |
Referências:
O radar pode aceitar webhook_url HTTPS para entrega de novos eventos.
3. Publicações do STF e Justiça Eleitoral
Monitore o DJe próprio do STF, o DJe do TSE e TREs e o Mural Eletrônico pela rota /v1/monitoramentos/publicacoes. A criação aceita filtros por termo, processo ou OAB, fontes e até cinco tribunais eleitorais. Novas correspondências podem ser entregues pelo evento publicacao_judicial_nova.
Veja Publicações do STF e Justiça Eleitoral para endpoints, preços e payload completo.
4. Processos administrativos
Monitore um NUP no Protocolo Integrado ou no SEI/IBAMA pela rota /v1/monitoramentos/processos-administrativos. A sincronização diária é o padrão e novas tramitações são entregues pelo evento movimentacao_processo_administrativo_nova.
Veja Processos administrativos para cobertura, limites e exemplos.
A consulta pontual de mandados públicos do BNMP/CNJ fica em Mandados de prisão (BNMP).
Painel
- Webhooks e logs: https://buscaprocessos.app.br/dashboard/webhooks
- Preços aplicados à sua conta: https://buscaprocessos.app.br/dashboard/pricing
Atualização pontual de processo
Além do monitoramento contínuo, existe atualização sob demanda:
POST /v1/processos/cnj/{cnj}/solicitar-atualizacao
GET /v1/processos/cnj/{cnj}/status-atualizacao
Use polling finito. Não solicite documentos públicos antes da conclusão.
Boas práticas
- Crie monitoramento só para CNJs/termos realmente necessários.
- Configure webhook antes de escalar volume.
- Trate remoção como interrupção de cobrança futura.
- Evite recriar o mesmo monitoramento em loop.
- Consulte saldo antes de ativações em lote.
Relacionados
Feed, arquivamento e refinamento de radares
Consulte o feed de resultados para visualizar os achados da conta agrupados por dia. A paginação é por dias; amostra limita os itens exibidos por radar. Use desde, ate, radar, q e arquivados para ajustar a seleção.
Arquive ou desarquive os achados por IDs ou por monitoramento. O arquivamento preserva os registros e não desativa o radar.
Para ajustar os filtros de um radar ativo, use PATCH de refinamento, enviando tribunais ou termosAuxiliares. O termo principal é fixo. Para monitorar outro termo, desative o radar e crie um novo.