Geral
O que é a Judit API?
A Judit API é uma solução completa para automação de consultas judiciais no Brasil. Permite consultar processos por CPF, CNPJ, OAB, NOME ou CNJ, monitorar atualizações automaticamente, baixar anexos (públicos e privados) e gerenciar credenciais de tribunais com segurança.Quais tribunais são suportados?
A Judit API suporta os principais tribunais brasileiros:- Estaduais: TJSP, TJRJ, TJMG, TJRS, TJPR, TJSC, entre outros
- Federais: TRF1, TRF2, TRF3, TRF4, TRF5, TRF6
- Superiores: STF, STJ, TST
- Especializados: Trabalhistas, Eleitorais, Militares
Como obter uma API Key?
Solicite sua chave por meio do WhatsApp comercial ou envie e-mail paraatendimento@judit.io. Você receberá:
- API Key de desenvolvimento (gratuita e limitada)
- Documentação de integração
- Acesso ao painel e suporte técnico
Autenticação
Minha API Key não está funcionando
Verifique os seguintes pontos:- Header
api-keyestá presente - A chave está válida (não expirou)
- A chave tem permissão para os endpoints usados
Consultas (Requests)
Como funciona a cobrança de anexos?
- Requests de anexos usam
search_type = lawsuit_attachment - Apenas requests com
search_type = lawsuit_cnjsão cobradas - PDFs individuais não geram cobrança separada
A consulta histórica cobra por documento consultado ou por processo processo retornado?
É cobrado por cada 1.000 processos retornados a cada documento consultado.Processos em segredo de justiça são retornados?
Depende. Para acessar, é necessário fornecer credenciais do advogado via cofre de credenciais.Um processo pode ter duas instâncias?
Sim. Um mesmo processo pode tramitar em mais de uma instância e, dependendo do tribunal, isso pode ocorrer de duas formas:- Mantendo o mesmo número de processo, quando o processo segue para outra instância sem alteração da numeração original.
- Gerando um novo número de processo, quando o tribunal cria uma nova numeração para representar a tramitação em outra instância ou algum desdobramento processual.
related_lawsuits.
Dessa forma, é possível diferenciar os dados de cada instância e, quando disponível, também identificar novas numerações relacionadas ao mesmo processo.
Posso cancelar uma consulta?
Não, após iniciado o processamento não é possível cancelar a execução.Busquei um processo e ele não foi encontrado
Nossa plataforma entrega exatamente as informações disponíveis nos tribunais. Caso um número de processo válido não seja encontrado, isso pode ocorrer por três motivos principais:- Número incorreto
- Processo sob segredo de justiça
- Processo baixado e indisponível no tribunal
Busquei um processo e ele está desatualizado
A atualização pode não ser instantânea, mas deve ocorrer em seguida. Se persistir, entre em contato com o suporte.Por quanto tempo posso acessar os dados da consulta?
As respostas ficam armazenadas por 6 meses a partir da data da request.Qual a diferença entre os campos private e secrecy_level?
secrecy_level: indica o nível de sigilo (0 a 5) do processoprivate: indica se um andamento é restrito a partes/advogados
Tracking (Monitoramento)
Como funciona o monitoramento?
Notifica automaticamente por webhook quando:Processual:
- Novos andamentos
- Alterações nas partes
- Inclusão de anexos (quando cadastrado com with_attachments: true)
- Mudança de status
Novas ações:
- Novo processo é distribuido para o documento monitorado
O que é o monitoramento de novas ações?
Verifica se novos processos foram abertos contra o CPF/CNPJ/OAB/Nome.O monitoramento de novas ações retorna fase e status?
Não. Para isso, use a consulta CNJ (search_type = lawsuit_cnj).
Performance e Custos
Como otimizar as consultas?
- Use filtros por data e tribunal
- Desative anexos se não forem necessários
- Implemente cache local para evitar duplicidade
Como reduzir custos?
- Evite reconsultas desnecessárias
- Use filtros e cache
- Acompanhe consumo pela rota
/requests
Qual o limite de requisições (rate limit) e timeout?
- Rate limit: 3 req/s
- Timeout criação: 15 segundos
- Timeout de finalização: até 1 hora (com retry automático)
Integração
Como integrar com meu sistema?
- Use webhooks para receber os dados
- Automatize requisições com base em eventos (ex: cadastro de cliente)
- Implemente logging e alertas de erro
Outras Funcionalidades
Quais tipos de busca estão disponíveis?
- CNJ (número do processo)
- CPF/CNPJ/OAB/Nome
- Consulta de histórico processual
- Consulta de mandados de prisão
- Contagem de processos
- Verificação se existe processo (True/False)
- Consulta de processos com resultado mascarado
- Consulta quantidade de processos atrelados a um documento.
- Consulta por dados agrupados de um documento.
- Judit IA
A API cobre processos extrajudiciais?
Ainda não atuamos em processos administrativos.Suporte
Como obter suporte técnico?
- Documentação: docs.judit.io
- E-mail:
atendimento@judit.io - Status de serviço: status.judit.io
Como reportar um bug?
Inclua:request_id- Data/Hora do erro
- Código de erro
- Descrição do erro
- Ambiente (prod/dev)
A Judit possui SLA?
| Plano | Uptime | Resposta | Suporte |
|---|---|---|---|
| Desenvolvimento | 95% | Melhor esforço | |
| Básico | 99% | < 2s | |
| Profissional | 99.5% | < 1s | Email + Chat |
| Enterprise | 99.9% | < 500ms | Dedicado 24/7 |
Próximos Passos
Ficou com dúvidas? Envie um e-mail para atendimento@judit.io ou entre em contato pelo nosso suporte.