Campos
| Campo | Tipo | Descrição |
|---|---|---|
numero_processo | string | Número unificado CNJ (20 dígitos) |
numero_formatado | string | Número formatado (ex: 0001234-56.2020.8.26.0100) |
tribunal | string | Sigla do tribunal em minúsculas (tjsp, tjrj, trt2, etc.) |
classe_codigo | number | Código da classe processual |
classe_nome | string | Nome da classe (Title Case) |
grau | string | Grau de jurisdição (G1, G2, etc.) |
data_ajuizamento | string | Data ISO (YYYY-MM-DD) |
orgao_julgador | string | Vara ou turma responsável (Title Case) |
assuntos | string | Assuntos do processo |
valor_acao | number | null | Valor da ação em reais; null quando não declarado |
partes | Parte[] | Lista de partes envolvidas |
advogados | Advogado[] | Lista de advogados atuantes |
movimentacoes | object[] | Até 10 movimentações mais recentes do processo |
Exemplo
Parte
| Campo | Tipo | Descrição |
|---|---|---|
nome | string | Nome da parte (Title Case) |
documento | string | CPF ou CNPJ formatado; string vazia ("") quando ausente |
polo | string | Polo capitalizado (ex: Ativo, Passivo, Terceiro, Outro) |
tipo | string | Pessoa Física, Pessoa Jurídica ou Autoridade |
Advogado
| Campo | Tipo | Descrição |
|---|---|---|
nome | string | Nome do advogado (Title Case) |
oab | string | Número OAB com UF (ex: SP123456) |
polo | string | Polo que representa (capitalizado) |
documento | string | CPF do advogado formatado; string vazia ("") quando ausente |
Movimentação
| Campo | Tipo | Descrição |
|---|---|---|
data | string | Data ISO (YYYY-MM-DD) |
descricao | string | Descrição da movimentação |
complemento | string | Complemento da movimentação; string vazia ("") quando ausente |
Filtro por categoria
Use?categorias= nos endpoints de CPF/CNPJ para filtrar por tipo:
| Categoria | Exemplos | Indica |
|---|---|---|
recuperacao-judicial | Recuperação Judicial | Empresa insolvente |
falencia | Falência, Insolvência | Empresa falida |
execucao-fiscal | Execução Fiscal | Dívida tributária |
execucao-civel | Execução de Título Extrajudicial | Cobrança de dívida |
trabalhista | Reclamação Trabalhista | Ação de funcionário |
criminal | Ação Penal | Processo criminal |
familia-sucessoes | Inventário, Divórcio | Família e sucessões |
Endpoints
| Rota | Descrição |
|---|---|
GET /processos/cpf/{cpf} | Processos de uma pessoa |
GET /processos/cnpj/{cnpj} | Processos de uma empresa |
GET /processos/numero/{numero} | Busca por número do processo |