Áreas do Processo (area)

Lista completa das áreas jurídicas que um processo pode ter:

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:

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:

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:

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