Áreas do Processo (area)

Lista completa das áreas jurídicas que um processo pode ter:
  • DIREITO À EDUCAÇÃO
  • DIREITO DA CRIANÇA E DO ADOLESCENTE
  • DIREITO DA SAÚDE
  • DIREITO DO CONSUMIDOR
  • DIREITO DO TRABALHO
  • DIREITO ASSISTENCIAL
  • DIREITO ADMINISTRATIVO E OUTRAS MATÉRIAS DE DIREITO PÚBLICO
  • DIREITO AMBIENTAL
  • DIREITO ELEITORAL
  • DIREITO INTERNACIONAL
  • DIREITO MARÍTIMO
  • DIREITO TRIBUTÁRIO
  • DIREITO PENAL
  • DIREITO PENAL MILITAR
  • DIREITO PREVIDENCIÁRIO
  • DIREITO PROCESSUAL CIVIL E DO TRABALHO
  • QUESTÕES DE ALTA COMPLEXIDADE, GRANDE IMPACTO E REPERCUSSÃO
  • REGISTROS PÚBLICOS

Níveis de Sigilo (secrecy_level)

Sistema de classificação de sigilo processual de 0 a 5:
NívelDescriçãoAcesso Permitido
0Processo sem sigilo ou públicoAcesso público geral
1Segredo de justiçaPartes e advogados
2Restrito aos servidores da unidade judicialServidores + partes
3Processo sigiloso, acesso apenas por magistrados, chefes de cartórios e assessores de gabineteMagistrados + chefes + assessores
4Processo sigiloso, acesso apenas por magistrados, chefes de cartórios e assessores de gabineteMagistrados + chefes + assessores
5Sigilo absoluto, acesso apenas pelo magistrado do processoApenas magistrado responsável
Processos com nível de sigilo maior que 0 podem ter informações limitadas ou omitidas na resposta da API, dependendo do nível de acesso do usuário autenticado.

Tipos de Justiça (justice_description)

Classificação dos órgãos do Poder Judiciário brasileiro:
  • SUPREMO TRIBUNAL FEDERAL
  • CONSELHO NACIONAL DE JUSTIÇA
  • SUPERIOR TRIBUNAL DE JUSTIÇA
  • TRIBUNAL REGIONAL FEDERAL
  • JUSTIÇA DO TRABALHO
  • JUSTIÇA ELEITORAL
  • JUSTIÇA MILITAR DA UNIÃO
  • JUSTIÇA MILITAR ESTADUAL
  • JUSTIÇA ESTADUAL

Status do Processo (status)

Estados possíveis de um processo judicial:
StatusDescrição
INICIALProcesso recém-distribuído ou em fase inicial
SENTENÇAProcesso com sentença proferida
EXECUÇÃO OU CUMPRIMENTOProcesso em fase de execução
TRÂNSITO JULGADO OU EM ACORDODecisão definitiva ou acordo homologado
RECURSOProcesso com recurso interposto
ARQUIVADOProcesso arquivado definitivamente
SUSPENSOProcesso temporariamente suspenso
SOBRESTADOProcesso sobrestado aguardando decisão
CANCELADOProcesso cancelado
ATIVOProcesso em andamento normal
FINALIZADOProcesso concluído

Situação do Processo (situation)

Informações sobre o status atual capturado do tribunal:
SituaçãoDescrição
INICIALSituação inicial do processo
SENTENÇAProcesso com sentença
EXECUÇÃO OU CUMPRIMENTOEm fase executória
TRÂNSITO JULGADO OU EM ACORDODecisão transitada em julgado
RECURSORecurso interposto
ARQUIVADOProcesso arquivado
SUSPENSOProcesso suspenso
SOBRESTADOProcesso sobrestado
CANCELADOProcesso cancelado
ATIVOProcesso ativo
FINALIZADOProcesso finalizado

Tipos de Pessoa (person_type)

Classificação das partes no processo:
  • ATIVO - Parte que move a ação
  • PASSIVO - Parte contra quem a ação é movida
  • INTERESSADO - Parte com interesse no processo
  • UNKNOWN - Tipo não identificado
  • RÉU - Parte demandada
  • AUTOR - Parte demandante
  • ADVOGADO - Representante legal
  • REQUERENTE - Parte que faz o requerimento
  • REQUERIDO - Parte contra quem se requer
  • ETC. - Outros papéis específicos

Fases do Processo (phase)

Fases processuais principais:
FaseDescrição
FASEFase genérica do processo
Esta enumeração pode ser expandida conforme novos dados sejam identificados nos tribunais.

Códigos de Andamento (step_type)

Os códigos de andamento seguem a Tabela de Movimentos do CNJ (Conselho Nacional de Justiça). Alguns exemplos comuns:
CódigoDescrição
DISTRIBUIÇÃOProcesso distribuído
CITAÇÃOCitação da parte
CONTESTAÇÃOApresentação de contestação
SENTENÇAProlação de sentença
RECURSOInterposição de recurso
ARQUIVAMENTOArquivamento do processo
Para a lista completa e atualizada dos códigos de movimentação, consulte a Tabela Processual Unificada (TPU) do CNJ.

Estados Brasileiros (state)

Siglas das Unidades Federativas:
  • AC - Acre
  • AP - Amapá
  • AM - Amazonas
  • PA - Pará
  • RO - Rondônia
  • RR - Roraima
  • TO - Tocantins
  • AL - Alagoas
  • BA - Bahia
  • CE - Ceará
  • MA - Maranhão
  • PB - Paraíba
  • PE - Pernambuco
  • PI - Piauí
  • RN - Rio Grande do Norte
  • SE - Sergipe
  • GO - Goiás
  • MT - Mato Grosso
  • MS - Mato Grosso do Sul
  • DF - Distrito Federal
  • ES - Espírito Santo
  • MG - Minas Gerais
  • RJ - Rio de Janeiro
  • SP - São Paulo
  • PR - Paraná
  • RS - Rio Grande do Sul
  • SC - Santa Catarina

Tipos de Documento (documents)

Tipos de documentos que podem estar associados às partes:
TipoDescrição
CPFCadastro de Pessoa Física
CNPJCadastro Nacional de Pessoa Jurídica
RGRegistro Geral
OABRegistro da Ordem dos Advogados do Brasil

Uso das Enumerações

Validação de Dados

// Exemplo de validação de nível de sigilo
const validSecrecyLevels = [0, 1, 2, 3, 4, 5];
const isValidSecrecy = validSecrecyLevels.includes(lawsuit.secrecy_level);

// Exemplo de validação de status
const validStatuses = [
  'INICIAL', 'SENTENÇA', 'EXECUÇÃO OU CUMPRIMENTO',
  'TRÂNSITO JULGADO OU EM ACORDO', 'RECURSO', 'ARQUIVADO',
  'SUSPENSO', 'SOBRESTADO', 'CANCELADO', 'ATIVO', 'FINALIZADO'
];
const isValidStatus = validStatuses.includes(lawsuit.status);

Filtragem por Enumerações

// Filtrar processos por área
const educationLawsuits = lawsuits.filter(
  lawsuit => lawsuit.area === 'DIREITO À EDUCAÇÃO'
);

// Filtrar processos públicos (sem sigilo)
const publicLawsuits = lawsuits.filter(
  lawsuit => lawsuit.secrecy_level === 0
);

Próximos Passos