Pular para o conteúdo principal
Version: 1.0.0

BuscaProcessos API

Transforme dados processuais em fluxos digitais​

A API BuscaProcessos conecta consultas, atualizações próprias, documentos públicos, intimações, monitoramentos e inteligência jurídica ao seu produto ou operação. Em vez de depender de pesquisas manuais e conferências periódicas, sua aplicação recebe dados estruturados em JSON e pode acionar jornadas automaticamente.

Benefícios​

  • reduza coleta, cópia e conferência manual de informações;
  • enriqueça CRMs, ERPs, portais, painéis e produtos jurídicos;
  • avance por níveis: descoberta, triagem, detalhe, conteúdo e monitoramento;
  • receba novidades por webhook e concentre a equipe na análise;
  • acompanhe consumo, requestId e status para operar com controle.

Esta referência descreve o contrato público versionado em /v1.

Como começar​

  1. Gere uma API key no painel BuscaProcessos.
  2. Faça chamadas a partir do seu servidor para https://api.buscaprocessos.app.br.
  3. Envie x-api-key ou Authorization: Bearer.
  4. Persista meta.requestId e meta.searchLogId para suporte e auditoria.
  5. Para operações assíncronas, consulte o status retornado até a conclusão; não repita uma solicitação paga sem verificar seu estado.

SLA de resposta e HTTP 202​

A janela pública total é de até 30 segundos. Quando uma consulta elegível precisa de mais tempo, ela continua no servidor e retorna HTTP 202 antes do timeout. Siga Location/data.statusUrl com a mesma API key e respeite Retry-After/pollAfterMs. O estado pendente não gera débito adicional; a cobrança da operação ocorre uma única vez.

Fluxos principais​

  • Documento: /processos?cpf_cnpj=... → /processos/cnj/{cnj} → movimentações, documentos públicos ou resumo.
  • Atualização: POST /processos/cnj/{cnj}/solicitar-atualizacao → GET /status-atualizacao → nova leitura do recurso.
  • Intimações: POST /intimacoes/oab → GET /intimacoes → link de /intimacoes/publicacoes/{diarioId}.
  • Monitoramento: POST /monitoramentos/processos ou /monitoramentos/novos-processos → listar resultados/status → receber webhook quando configurado.

Webhooks​

As configurações de monitoramento aceitam webhook_url HTTPS. A BuscaProcessos entrega eventos por POST JSON, com identificador de entrega, evento, timestamp e dados normalizados. Responda 2xx rapidamente, deduplique por id/Delivery-Id e processe em fila.

Custos e erros​

O custo depende do tipo de consulta, opções e plano; quando aplicável, a resposta informa creditsCharged e creditsRemaining. Não faça fan-out automático para capa, documentos, PDFs ou IA. Trate 401, 403, 422, 429 e indisponibilidades temporárias de forma explícita.

Authentication​

Chave de API fornecida pelo BuscaProcessos.

Security Scheme Type:

apiKey

Header parameter name:

x-api-key

Contact

BuscaProcessos:

URL: https://buscaprocessos.app.br