Transforme dados processuais em produtividade e automação

Começar grátis e testar a API

O plano Free custa R$ 0 e inclui R$ 50 em créditos de consulta, com ativação imediata e sem cartão. Crie uma conta em https://buscaprocessos.app.br/contratar?produto=api&plano=free para validar a integração. Os testes usam créditos do saldo gratuito; não é obrigatório comprar um pacote de R$ 150 para começar. O plano Free não inclui webhooks nem gestão de equipe. Confira os planos em https://buscaprocessos.app.br/api-integracoes#planos-api.

O teste usa o ambiente normal da API. Recargas pagas são opcionais para começar e ficam disponíveis quando você precisar ampliar o uso.

Integre consultas processuais, monitoramento, intimações, documentos e inteligência jurídica diretamente ao seu sistema — com dados estruturados para alimentar produtos, operações e decisões.

A API BuscaProcessos reduz o trabalho de pesquisar, copiar, conferir e acompanhar informações manualmente. Sua aplicação passa a consultar dados sob demanda, receber novidades por webhook e aprofundar cada caso somente quando houver necessidade.

Use a API com assistentes de IA via MCP

O servidor MCP próprio da BuscaProcessos conecta consultas processuais a ferramentas como Cursor, Claude Code e VS Code. Ele usa a mesma API Key, o mesmo saldo e os mesmos descontos da sua conta.

🔐 Uma única credencial
Use somente sua API Key da BuscaProcessos no header x-api-key. Use a chave da sua conta BuscaProcessos.

URL do servidor MCP: https://api.buscaprocessos.app.br/mcp

{
  "mcpServers": {
    "BuscaProcessos": {
      "url": "https://api.buscaprocessos.app.br/mcp",
      "headers": {
        "x-api-key": "SUA_API_KEY_DA_BUSCAPROCESSOS"
      }
    }
  }
}

Vantagens práticas

descubra os endpoints e schemas reais antes de implementar;
gere clientes, exemplos, validações e testes alinhados à referência publicada;
peça ao assistente para explicar autenticação, parâmetros e respostas sem copiar a documentação para o chat;
mantenha a API Key no cofre de segredos do cliente MCP;
consulte saldo, preços, processos por OAB ou documento, capa e movimentações sem montar requisições HTTP manualmente;
operações pagas informam o custo e exigem confirmação antes da execução.

Dicas para usar com segurança e eficiência

Comece pedindo ao assistente para listar ou pesquisar endpoints; só então peça a implementação.
Informe o objetivo de negócio e o ambiente: por exemplo, “monitore uma carteira de CNJs e envie eventos para meu webhook”.
Revise parâmetros e exemplos antes de executar chamadas. Operações de consulta, documentos, IA e monitoramento podem consumir créditos.
Armazene a API Key em variável de ambiente ou no cofre de segredos do cliente; nunca a registre no repositório, no frontend ou em prompts compartilhados.
Confirme o custo exibido pelo assistente antes de autorizar uma ferramenta paga.

📘 O que o MCP pode acessar
O MCP expõe somente ferramentas específicas da BuscaProcessos. Ele não substitui as permissões da conta, nem ignora créditos, descontos, regras de cobrança ou controles da API. Veja a configuração completa em MCP BuscaProcessos.

Fazer a primeira chamada

Valide sua integração e receba os primeiros processos em JSON.

Ver soluções e casos de uso

Descubra como automatizar carteiras, intimações, due diligence e produtos jurídicos.

Explorar os endpoints

Consulte parâmetros, exemplos, respostas e próximos passos de cada operação.

O salto de produtividade

Uma consulta isolada entrega informação. Uma integração bem desenhada transforma essa informação em processo operacional.

Antes da integração	Com a API BuscaProcessos
Pesquisas manuais e repetitivas	Consultas integradas ao seu sistema
Alternância entre fontes e telas	Respostas JSON em um contrato único
Conferência periódica de novidades	Monitoramentos contínuos e eventos por webhook
Cópia de dados para CRM ou planilhas	Enriquecimento automático de cadastros e fluxos
Consulta completa antes de saber se é relevante	Jornada progressiva: descoberta → triagem → detalhe → documentos
Pouca visibilidade sobre cada execução	Metadados de consumo, `requestId` e status para auditoria

O que você pode construir

consulta processual dentro de CRMs, ERPs, portais e aplicativos;
triagem de pessoas e empresas para due diligence e análise de risco;
acompanhamento automatizado de carteiras processuais;
central de intimações por OAB com histórico e conteúdo de publicações;
alertas e tarefas acionados por novas movimentações ou processos;
busca e qualificação de novos processos por termo;
acesso controlado a documentos públicos e resumos por IA;
painéis e indicadores jurídicos alimentados por dados estruturados.

📘 Uma API, vários níveis de profundidade
Comece com uma listagem ou resumo, aprofunde apenas os processos relevantes e ative monitoramento somente para o que precisa de acompanhamento contínuo. Isso melhora produtividade e previsibilidade de custo.

Visão geral técnica

A BuscaProcessos oferece uma API pública versionada em /v1 para consulta de dados processuais públicos no Brasil e automação jurídica.

Ela é indicada para desenvolvedores, arquitetos, legaltechs, departamentos jurídicos, Legal Operations, compliance, cobrança, análise de risco, due diligence e produtos que precisam transformar dados processuais em fluxos digitais.

Como a integração funciona

Sua aplicação autentica cada requisição com a API Key da conta.
A API consulta os serviços disponíveis e devolve um envelope JSON com data e meta.
Operações síncronas respondem na mesma chamada.
Operações assíncronas retornam status/identificador e exigem polling ou webhook/callback.
O consumo é debitado em créditos conforme o endpoint utilizado.

📘 Host obrigatório
Use sempre https://api.buscaprocessos.app.br. Chamadas em host diferente podem retornar INVALID_API_HOST.

Comece em poucos passos

Crie uma conta Free em Começar grátis. O plano inclui R$ 50 em créditos de consulta para avaliar a API, sem cartão para começar.
Confirme seu e-mail e acesse o Console API. Abra API Keys e gere ou copie sua chave.
Faça a primeira requisição no seu backend. Comece por GET /v1/processos?cpf_cnpj=... e siga o guia de primeira requisição.
Trate o resultado. Respeite paginação, erros e HTTP 202 e acompanhe o saldo e o consumo no painel.
Amplie conforme seu fluxo. Consulte capa, documentos e resumos somente para os processos que precisam de aprofundamento. Configure monitoramentos e webhooks conforme os recursos do plano.
Recarregue quando necessário. Pacotes pagos e recargas começam em R$ 150. Consulte créditos e preços e os planos atuais.

O plano Free é usado no ambiente normal da API. Os R$ 50 são créditos de consulta; não há um sandbox separado. Webhooks e gestão de equipe dependem do plano contratado.

Como gerar a API Key

Pré-requisitos

Conta no plano Free ou em um plano pago. Comece grátis.
Acesso ao Console API e e-mail confirmado
Conta com status ativo
Acesso ao Console API

Caminho no painel

Entre em https://buscaprocessos.app.br/dashboard/keys.
Clique em Nova chave (topo) ou Gerar nova chave (tabela).
No modal Gerar API key / Gerar nova chave, leia o aviso e clique em Gerar chave.
A chave aparece na lista Suas chaves, oculta por padrão.
Clique no ícone de olho para Revelar chave e no ícone de copiar para Copiar chave.

Como funciona

Item	Comportamento
Prefixo	`bp_live_`
Nome exibido	`BuscaProcessos API`
Escopos	Não há escopos configuráveis na geração
Quantidade	Uma chave ativa por conta
Regeneração	Nova chave substitui a anterior imediatamente
Revogação	Botão Revogar → Confirmar revogação (remove a chave da conta)
Reexibição	A chave completa permanece associada à conta e pode ser revelada novamente

⚠️ Atenção
Ao gerar uma nova chave, a anterior deixa de funcionar imediatamente. Atualize a credencial em todos os ambientes antes de rotacionar em produção.

Segurança da API Key

Nunca exponha sua API Key em aplicações frontend, repositórios públicos,
aplicativos distribuídos ao usuário ou código JavaScript executado no navegador.

Guarde a chave em variável de ambiente ou secret manager.
Não envie a chave em URL, analytics, tickets públicos ou logs de aplicação.
Prefira rotação imediata se houver suspeita de vazamento.

Guia completo: API Keys.

Autenticação

A API aceita dois formatos de autenticação:

Formato	Header
Recomendado	`x-api-key: bp_live_SUA_CHAVE`
Alternativo	`Authorization: Bearer bp_live_SUA_CHAVE`

URL base

https://api.buscaprocessos.app.br

Exemplo

curl --request GET \
  --url 'https://api.buscaprocessos.app.br/v1/processos?cpf_cnpj=00000000000' \
  --header 'x-api-key: bp_live_SUA_CHAVE' \
  --header 'Accept: application/json'

Variável de ambiente

BUSCAPROCESSOS_API_KEY=bp_live_sua_chave_aqui

Erros de autenticação e acesso

HTTP	Código	Significado
401	`API_KEY_REQUIRED`	Header ausente
401	`INVALID_API_KEY`	Chave inválida
403	`ACCOUNT_INACTIVE`	Conta inativa
403	`EMAIL_VERIFICATION_REQUIRED`	E-mail não confirmado
403	`INSUFFICIENT_CREDITS`	Saldo insuficiente
404	`INVALID_API_HOST`	Host da API incorreto

Guia completo: Autenticação.

Primeira requisição

Endpoint mais simples para validar a integração:

GET /v1/processos?cpf_cnpj={cpf_ou_cnpj}

Documento apenas com dígitos (CPF 11 ou CNPJ 14).
Use valores fictícios em exemplos e documentação.
A resposta usa o envelope data + meta.
meta pode incluir creditsRemaining, requestId, searchLogId e servedAt.

cURL

curl --request GET \
  --url 'https://api.buscaprocessos.app.br/v1/processos?cpf_cnpj=00000000000' \
  --header "x-api-key: ${BUSCAPROCESSOS_API_KEY}" \
  --header 'Accept: application/json'

TypeScript / Node.js

const apiKey = process.env.BUSCAPROCESSOS_API_KEY;
if (!apiKey) {
  throw new Error("Defina BUSCAPROCESSOS_API_KEY");
}

const document = "00000000000"; // fictício

const response = await fetch(
  `https://api.buscaprocessos.app.br/v1/processos?cpf_cnpj=${document}`,
  {
    method: "GET",
    headers: {
      "x-api-key": apiKey,
      Accept: "application/json",
    },
  },
);

const body = await response.json();

if (!response.ok) {
  console.error("Falha na API", response.status, body?.error);
  throw new Error(body?.error?.message || "Erro na consulta");
}

console.log(body.data);
console.log(body.meta);

Python

import os
import requests

api_key = os.environ["BUSCAPROCESSOS_API_KEY"]
document = "00000000000"  # fictício

response = requests.get(
    "https://api.buscaprocessos.app.br/v1/processos",
    params={"cpf_cnpj": document},
    headers={"x-api-key": api_key, "Accept": "application/json"},
    timeout=35,
)

if not response.ok:
    raise RuntimeError(f"{response.status_code}: {response.text}")

payload = response.json()
print(payload.get("data"))
print(payload.get("meta"))

PHP

<?php
$apiKey = getenv('BUSCAPROCESSOS_API_KEY');
$document = '00000000000'; // fictício

$ch = curl_init('https://api.buscaprocessos.app.br/v1/processos?cpf_cnpj=' . urlencode($document));
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'x-api-key: ' . $apiKey,
    'Accept: application/json',
  ],
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($status < 200 || $status >= 300) {
  throw new RuntimeException("HTTP $status: $body");
}

$data = json_decode($body, true);
print_r($data['data'] ?? null);

Mais detalhes: Primeira requisição · Listar processos por CPF ou CNPJ.

Fluxo visual da integração

Sua aplicação
    ↓  x-api-key
API BuscaProcessos (https://api.buscaprocessos.app.br)
    ↓
Consulta aos serviços disponíveis
    ↓
Resposta síncrona (data + meta)
    ou
Processamento assíncrono (status / requestId)
    ↓
Webhook da conta  ou  polling de status
    ↓
Seu sistema processa o resultado

Principais recursos

Consulta por CPF ou CNPJ

Liste processos vinculados a um documento com GET /v1/processos.

Consulta por número CNJ

Consulte capa, movimentações e detalhes de um processo.

Consulta por OAB

Localize processos e fluxos relacionados à inscrição da OAB.

Monitoramento de processos

Monitore CNJs e radares de novos processos.

Intimações

Monitore e consulte intimações por OAB.

Resumo por IA

Obtenha resumo inteligente de um processo por CNJ.

Webhooks

Receba eventos na sua aplicação com assinatura e tentativas de reenvio.

Documentos públicos

Liste documentos públicos próprios e faça download de PDFs.

Playground

Teste endpoints no painel com a API Key da conta (créditos reais).

Créditos e consumo

Entenda recarga, saldo, extrato e consumo por chamada.

Entendendo respostas síncronas e assíncronas

Janela síncrona

A API tenta concluir a operação na mesma conexão e possui uma janela pública total de até 30 segundos. Dois segundos são reservados internamente para serializar e entregar a resposta com segurança. Quando o resultado fica pronto dentro da janela, o endpoint devolve seu status normal (200, 201, 404, 422 etc.) e o envelope correspondente:

{
  "data": {},
  "meta": {
    "creditsRemaining": 0,
    "requestId": "exemplo",
    "searchLogId": null,
    "servedAt": "14:32:10"
  }
}

HTTP 202 antes do timeout

Quando uma consulta elegível precisa de mais tempo — por exemplo, consolidação de fontes oficiais por OAB, consulta de CNJ, intimações, documentos ou qualificação — a API não mantém a conexão até ocorrer timeout. O trabalho continua no servidor e a chamada recebe HTTP 202 Accepted:

{
  "data": {
    "status": "PROCESSANDO",
    "requestId": "5f5342bf-8a4f-47e9-a13c-1fe20b879ca2",
    "message": "A consulta continua em segundo plano. Consulte a statusUrl até receber a resposta final.",
    "statusUrl": "https://api.buscaprocessos.app.br/v1/requests/5f5342bf-8a4f-47e9-a13c-1fe20b879ca2",
    "pollAfterMs": 5000,
    "pollAfterSeconds": 5,
    "nextPollAt": "2026-08-14T14:32:15.000Z",
    "submittedAt": "2026-08-14T14:32:10.000Z"
  },
  "meta": {
    "creditsCharged": 0
  }
}

A resposta também inclui:

Location: a mesma URL de acompanhamento;
Retry-After: intervalo mínimo recomendado, em segundos;
data.pollAfterMs: o intervalo equivalente, em milissegundos;
data.pollAfterSeconds: o mesmo intervalo, em segundos, pronto para configurar o timer;
data.nextPollAt: o instante ISO 8601 a partir do qual a próxima tentativa é recomendada.

O 202 é um estado de processamento, não um erro. Ele não cria débito adicional. A operação é executada e cobrada uma única vez; a URL de status apenas reproduz a resposta final armazenada.

Padrão recomendado:

Se a resposta não for 202, trate-a normalmente.
Em 202, persista data.requestId e data.statusUrl (ou o header Location).
Aguarde Retry-After ou data.pollAfterMs.
Faça GET na statusUrl com a mesma API key.
Enquanto receber 202, repita o polling com limite de tentativas.
Ao receber um status diferente de 202, trate aquela resposta como a resposta final original.

async function fetchWithProcessing(url: string, apiKey: string) {
  for (let attempt = 0; attempt < 60; attempt += 1) {
    const response = await fetch(url, {
      headers: { "x-api-key": apiKey, Accept: "application/json" },
    });

    if (response.status !== 202) return response;

    const pending = await response.json();
    const retryAfterMs =
      Number(response.headers.get("Retry-After") || 0) * 1000 ||
      pending.data?.pollAfterMs ||
      5000;
    const nextUrl =
      response.headers.get("Location") || pending.data?.statusUrl;

    if (!nextUrl) throw new Error("202 sem statusUrl");
    url = nextUrl;
    await new Promise((resolve) => setTimeout(resolve, retryAfterMs));
  }

  throw new Error("Limite de polling excedido");
}

📘 Polling
Não recrie a operação original a cada tentativa. Siga sempre a URL retornada. Algumas operações assíncronas de negócio podem responder com uma nova statusUrl; nesse caso, continue pelo endereço mais recente.

Guia de webhooks e callbacks: Webhooks.

Créditos e consumo

Cada chamada autenticada de negócio pode consumir créditos conforme o endpoint.
O saldo da conta é a soma de recargas (e, quando houver, créditos de assinatura ativa).
Saldo insuficiente retorna HTTP 403 com código INSUFFICIENT_CREDITS.
Headers de resposta podem expor X-BuscaProcessos-Credits-Remaining e X-BuscaProcessos-Request-Id.

Onde operar no painel

Ação	Menu	Rota
Ver saldo	Visão Geral	Abrir painel
Recarregar	Recarga	Abrir Recarga
Ver uso	Uso	Abrir Uso
Ver extrato	Extrato	Abrir Extrato
Assinatura	Assinatura	Abrir Assinatura

Recarga

Mínimo: R$ 150,00
Valores sugeridos no Console API: R$ 150, R$ 300, R$ 500 e R$ 1.000
Métodos: PIX e cartão de crédito
Também existe recarga automática por cartão (configurável na mesma área)

⚠ Consulte sempre os valores vigentes antes de integrar.
Veja Créditos e preços e Preços da API.

Erros comuns

HTTP	Código	Significado	Como resolver
401	`API_KEY_REQUIRED`	Chave ausente	Envie `x-api-key` ou `Authorization: Bearer`
401	`INVALID_API_KEY`	Chave inválida ou revogada	Gere ou copie a chave em API Keys
403	`ACCOUNT_INACTIVE`	Conta inativa	Contate o suporte
403	`EMAIL_VERIFICATION_REQUIRED`	E-mail não confirmado	Conclua a verificação de e-mail
403	`INSUFFICIENT_CREDITS`	Saldo insuficiente	Recarregue em Recarga
400	`MISSING_DOCUMENT`	Documento ausente	Envie `cpf_cnpj` ou `document`
422	`INVALID_DOCUMENT`	Documento inválido	Use apenas dígitos de CPF/CNPJ válidos
422	`INVALID_LIMIT`	`limit` inválido	Use `50` ou `100` em `/v1/processos`
404	—	Sem processos / recurso não encontrado	Valide o termo; trate 404 de lista vazia
404	`INVALID_API_HOST`	Host incorreto	Use `api.buscaprocessos.app.br`
429	—	Rate limit	Respeite `Retry-After` e faça backoff
502	`UPSTREAM_UNAVAILABLE`	Fonte temporariamente indisponível	Retente com backoff; não faça fan-out agressivo

Tabela ampliada: Erros.

Segurança

Armazene a API Key apenas no servidor ou em um gerenciador de segredos.
Nunca envie a chave para o frontend ou apps mobile embutidos.
Não registre a chave completa em logs, APM ou analytics.
Use sempre HTTPS.
Rotacione a chave em API Keys se houver exposição.
Revogue chaves não utilizadas.
No webhook, valide HMAC (X-BuscaProcessos-Signature) quando configurado e deduplique por id / X-BuscaProcessos-Delivery-Id.
Responda 2xx rapidamente no receptor e processe o payload em fila.

Guia: Segurança.

Links rápidos

Destino	Link
Esta página	/docs/getting-started
Autenticação	/docs/autenticacao
API Keys	/docs/api-keys
Primeira requisição	/docs/primeira-requisicao
API Reference	/reference
Playground	Painel
Webhooks	/docs/webhooks
Créditos e preços	/docs/creditos-e-precos
Erros	/docs/erros
Paginação	/docs/paginacao
Monitoramento	/docs/monitoramento
Intimações	/docs/intimacoes
Segurança	/docs/seguranca
Preços e referências	Preços da API
Suporte WhatsApp	Falar com suporte

Próximos passos recomendados

Validar autenticação com GET /v1/processos.
Implementar tratamento de error.code e status HTTP.
Persistir requestId / searchLogId para suporte e auditoria.
Controlar custo: não fazer fan-out automático para capa, movimentações, documentos e IA de todos os processos retornados.
Configurar webhooks antes de ligar monitoramentos em produção.
Explorar a API Reference para o fluxo do seu produto.

Começar grátis e testar a API​

Use a API com assistentes de IA via MCP​

Vantagens práticas​

Dicas para usar com segurança e eficiência​

O salto de produtividade​

O que você pode construir​

Visão geral técnica​

Como a integração funciona​

Comece em poucos passos​

Como gerar a API Key​

Pré-requisitos​

Caminho no painel​

Como funciona​

Segurança da API Key​

Autenticação​

URL base​

Exemplo​

Variável de ambiente​

Erros de autenticação e acesso​

Primeira requisição​

cURL​

TypeScript / Node.js​

Python​

PHP​

Fluxo visual da integração​

Principais recursos​

Entendendo respostas síncronas e assíncronas​

Janela síncrona​

HTTP 202 antes do timeout​

Créditos e consumo​

Onde operar no painel​

Recarga​

Erros comuns​

Segurança​

Links rápidos​

Próximos passos recomendados​