Ogmmajus — API de tribunais brasileiros
Drop-in replacement do Escavador. Schema 100% compatível: troque a base URL e seu cliente continua funcionando. Em produção: processos, movimentações, advogados, OAB, monitoramentos, certificados digitais e resumo IA.
Comece em 60 segundos
curl https://api.ogmmajus.com.br/api/v2/processos/numero_cnj/5024307-65.2020.8.24.0008 \
-H "Authorization: Bearer SEU_TOKEN"
Resposta 200 OK com a capa, partes, advogados (com OAB quando exposta) e fontes (1º e 2º grau quando disponíveis).
🚀 Primeiros passos
📚 Reference v2
🗂 Reference v1
🛠 Tribunais
O que dá pra fazer
| Recurso | Endpoint principal | Versão | Pricing típico |
|---|---|---|---|
| Capa do processo (partes, advogados, fontes) | GET /api/v2/processos/numero_cnj/{cnj} | v2 | R$ 0,05 / chamada |
| Movimentações (ANDAMENTO + PUBLICACAO) | GET /api/v2/processos/numero_cnj/{cnj}/movimentacoes | v2 | R$ 0,10 / chamada |
| Processos por advogado (OAB) | GET /api/v2/advogado/processos | v2 | sob plano |
| Processos por CPF/CNPJ | GET /api/v2/envolvido/processos | v2 | sob plano |
| Atualização on-demand (refresh do tribunal) | POST .../solicitar-atualizacao | v2 | varia por tribunal |
| Monitorar processo (callback em movimentação) | POST /api/v2/monitoramentos/processos | v2 | mensal por CNJ |
| Monitorar OAB / CPF / nome (novos processos) | POST /api/v2/monitoramentos/novos-processos | v2 | mensal por termo |
| Certificado digital A1 (PJe, e-SAJ) | POST /api/v2/certificados | v2 | sob plano |
| Resumo do processo via IA | POST .../ia/resumo/solicitar-atualizacao | v2 | extra IA |
| Busca textual unificada (jurisprudência) | GET /api/v1/busca | v1 | varia |
| Monitorar termo nos diários oficiais | POST /api/v1/monitoramentos | v1 | mensal por termo |
Migrar do Escavador é instantâneo
Já usa Escavador? Trocar só a base URL é suficiente — schema, paths, params e formato de erro são idênticos.
- Antes (Escavador)
- Depois (Ogmmajus)
const r = await fetch(
'https://api.escavador.com/api/v2/processos/numero_cnj/' + cnj,
{ headers: { Authorization: 'Bearer ESC_TOKEN' } }
);
const r = await fetch(
'https://api.ogmmajus.com.br/api/v2/processos/numero_cnj/' + cnj,
{ headers: { Authorization: 'Bearer OGM_TOKEN' } }
);
Sem mudar parsing, tipos, tratamento de erro ou cliente HTTP.
Exemplos rápidos
- cURL
- Node.js
- Python
# Capa do processo
curl https://api.ogmmajus.com.br/api/v2/processos/numero_cnj/5024307-65.2020.8.24.0008 \
-H "Authorization: Bearer SEU_TOKEN"
# Movimentações paginadas
curl "https://api.ogmmajus.com.br/api/v2/processos/numero_cnj/5024307-65.2020.8.24.0008/movimentacoes?cursor=" \
-H "Authorization: Bearer SEU_TOKEN"
# Processos por OAB
curl "https://api.ogmmajus.com.br/api/v2/advogado/processos?oab=SC18477" \
-H "Authorization: Bearer SEU_TOKEN"
import fetch from 'node-fetch';
const BASE = 'https://api.ogmmajus.com.br';
const TOKEN = process.env.OGMMAJUS_TOKEN;
async function get(path) {
const r = await fetch(`${BASE}${path}`, {
headers: { Authorization: `Bearer ${TOKEN}` },
});
if (!r.ok) throw new Error(`${r.status} ${r.statusText}`);
return r.json();
}
const cnj = '5024307-65.2020.8.24.0008';
const capa = await get(`/api/v2/processos/numero_cnj/${cnj}`);
const movs = await get(`/api/v2/processos/numero_cnj/${cnj}/movimentacoes`);
console.log(capa.titulo_polo_ativo, movs.items.length, 'movimentações');
import os
import httpx
BASE = "https://api.ogmmajus.com.br"
TOKEN = os.environ["OGMMAJUS_TOKEN"]
client = httpx.Client(
base_url=BASE,
headers={"Authorization": f"Bearer {TOKEN}"},
timeout=30.0,
)
cnj = "5024307-65.2020.8.24.0008"
capa = client.get(f"/api/v2/processos/numero_cnj/{cnj}").json()
movs = client.get(f"/api/v2/processos/numero_cnj/{cnj}/movimentacoes").json()
print(capa["titulo_polo_ativo"], len(movs["items"]), "movimentações")
Conceitos essenciais
| Tópico | Resumo |
|---|---|
| Autenticação Bearer | Token único por workspace, escopo único, rotação simples. |
| Paginação | v2 usa cursor (cursor + li); v1 usa page. Resposta sempre traz o próximo. |
| Cache | Capa cacheada 24h. Pra forçar refresh use solicitar-atualizacao. |
| Pricing | Cobrança por chamada bem-sucedida (2xx). Erros não cobram. |
| Erros | code semântico + message legível + status HTTP padrão. |
| Callbacks (webhooks) | Assinatura HMAC, retry exponencial, dedup por idempotency_key. |
SLA & Status
| Métrica | Compromisso |
|---|---|
| Uptime da API gateway | 99,9% mensal |
| Latência capa de processo (cache hit) | p95 < 300ms |
| Latência atualização on-demand | p95 < 30s (varia por tribunal) |
| Frescor dos dados | 24h (cache) ou tempo real (atualização on-demand) |
| Suporte | Resposta em até 24h em dias úteis |
🟢 Status público — incidentes ativos, manutenções planejadas, métricas em tempo real.
Cobertura de tribunais
Hoje cobrindo os principais tribunais estaduais e federais. A exposição de OAB pública, autos digitais e PDF de movimentações varia por tribunal — veja a página dedicada de cobertura:
Highlights:
- ✅ TJSC eproc — capa + movimentações + OAB pública + autos digitais
- ✅ TJSP e-SAJ — capa + movimentações (OAB privada)
- ✅ TJRJ, TJBA, TJPR, TJRS — capa + movimentações (OAB varia)
- ✅ TRFs federais — capa + movimentações
- 🟡 Justiça do Trabalho — em rollout
- 🟡 STJ / STF — em rollout
Pricing em 1 minuto
| Plano | Capa de processo | Movimentações | Atualização on-demand | Monitoramentos |
|---|---|---|---|---|
| Free trial | 100/mês | 100/mês | — | 1 ativo |
| Starter | R$ 0,05/chamada | R$ 0,10/chamada | R$ 0,30 | R$ 1/CNJ/mês |
| Pro | R$ 0,03/chamada | R$ 0,06/chamada | R$ 0,15 | R$ 0,50/CNJ/mês |
| Enterprise | sob orçamento | sob orçamento | volume | volume |
Erros HTTP (4xx/5xx) nunca são tarifados. Cache hits também não.
Suporte
- 📧 Email — contato@ogmmajus.com.br (resposta em 24h úteis)
- 🎛 Painel — api.ogmmajus.com.br/painel (cobrança, tokens, monitoramentos, logs)
- 📊 Status — api.ogmmajus.com.br/painel
Próximos passos
- 📝 Crie sua conta e ganhe 100 chamadas grátis pra testar.
- 🔑 Gere um token no painel.
- 🚀 Faça sua primeira requisição seguindo o passo a passo.
- 📚 Explore os 80+ endpoints por categoria.