Estrutura Geral

O objeto lawsuit é organizado em seções principais que agrupam informações relacionadas:
  • response_data: Dados principais do processo
  • PARTES (parties): Informações sobre as partes envolvidas
  • ANDAMENTO (steps): Histórico de movimentações processuais
  • ANEXOS (attachments): Documentos anexados ao processo

Propriedades Principais

response_data

PropriedadeTipoDescrição
areastringÁrea do processo (ex: DIREITO À EDUCAÇÃO, DIREITO ADMINISTRATIVO, etc.)
namestringDescrição/nome do processo
distribution_datestringData de distribuição
instancestringGrau do processo (instância)
courtstringFórum responsável
secrecy_levelintegerNível de sigilo ou segredo (0-5)

Níveis de Sigilo

O sistema utiliza níveis de 0 a 5 para classificar o sigilo processual. Para a lista completa de níveis e suas descrições, consulte Enumerações do Objeto Lawsuit.

CAPA (Cover Information)

PropriedadeTipoDescrição
subjectsstringAssuntos do processo
classificationsstringClasses processuais
judgestringNome do juiz/relator
codestringNúmero do processo (CNJ)
justice_descriptionstringTipo de justiça

Tipos de Justiça

Para a lista completa dos tipos de justiça e órgãos do Poder Judiciário, consulte Enumerações do Objeto Lawsuit.

Informações de Localização

PropriedadeTipoDescrição
countystringComarca
tribunal_acronymstringSigla do tribunal
citystringCidade
statestringUF (Unidade Federativa)
situationstringSituação atual do processo

Status e Fase do Processo

PropriedadeTipoDescrição
phasestringFase atual (ex: FASE)
statusstringStatus do processo

Possíveis Status

Para a lista completa de status possíveis e suas descrições, consulte Enumerações do Objeto Lawsuit.

Informações sobre Valor da Causa

PropriedadeTipoDescrição
amountstringValor da causa
namestringNome da parte
main_documentstringDocumento principal da parte (CPF ou CNPJ)
sidestringPolo da parte
person_typestringPapel da parte no processo

Tipos de Pessoa

Para a lista completa de tipos de pessoa e papéis processuais, consulte Enumerações do Objeto Lawsuit.

PARTES (Parties)

Documentos das Partes

PropriedadeTipoDescrição
documentsarrayLista de documentos da parte
lawyersarrayLista de advogados

Advogados

PropriedadeTipoDescrição
lawyersarrayLista dos advogados de uma parte
Caso o tribunal não identifique que o advogado é de uma parte específica, o advogado estará no array principal de PARTES.

ANDAMENTO (Steps)

Representa o histórico de movimentações do processo.
PropriedadeTipoDescrição
step_datestringData do andamento
step_typestringCódigo do andamento
contentstringConteúdo do andamento
privatebooleanCaso seja um andamento sob sigilo
step_idstringID do andamento
De acordo com a tabela de movimentos do CNJ, alguns andamentos podem estar amarrados com o andamento.

ANEXOS (Attachments)

Documentos anexados ao processo.
PropriedadeTipoDescrição
attachment_datestringData do anexo
attachment_namestringTítulo do anexo

Exemplos de Uso

Estrutura do Objeto Lawsuit

{
  "response_data": {
    "area": "DIREITO CIVIL",
    "name": "Ação de Cobrança",
    "distribution_date": "2024-01-15",
    "instance": "1ª INSTÂNCIA",
    "court": "1ª VARA CÍVEL",
    "secrecy_level": 0,
    "subjects": "COBRANÇA",
    "classifications": "PROCEDIMENTO COMUM",
    "judge": "João Silva Santos",
    "code": "9999999-99.9999.9.99.9999",
    "justice_description": "JUSTIÇA ESTADUAL",
    "county": "SÃO PAULO",
    "tribunal_acronym": "TJSP",
    "city": "SÃO PAULO",
    "state": "SP",
    "situation": "ATIVO",
    "phase": "CONHECIMENTO",
    "status": "INICIAL",
    "amount": "R$ 50.000,00"
  },
  "parties": [
    {
      "name": "EMPRESA XYZ LTDA",
      "main_document": "12.345.678/0001-90",
      "side": "ATIVO",
      "person_type": "AUTOR",
      "documents": ["CNPJ"],
      "lawyers": [
        {
          "name": "Maria Advogada",
          "oab": "OAB/SP 123456"
        }
      ]
    }
  ],
  "steps": [
    {
      "step_date": "2024-01-15",
      "step_type": "DISTRIBUIÇÃO",
      "content": "Processo distribuído para a 1ª Vara Cível",
      "private": false,
      "step_id": "001"
    }
  ],
  "attachments": [
    {
      "attachment_date": "2024-01-15",
      "attachment_name": "Petição Inicial"
    }
  ]
}

Consumindo a API

# Buscar processo por número CNJ
curl -X GET "https://api.judit.io/v1/lawsuits/9999999-99.9999.9.99.9999" \
  -H "Authorization: Bearer $JUDIT_API_KEY" \
  -H "Content-Type: application/json"

# Buscar processos com filtros
curl -X GET "https://api.judit.io/v1/lawsuits?area=DIREITO_CIVIL&status=ATIVO" \
  -H "Authorization: Bearer $JUDIT_API_KEY" \
  -H "Content-Type: application/json"

Considerações Importantes

O objeto lawsuit é dinâmico e pode conter propriedades adicionais dependendo do tipo de processo e tribunal de origem.
Processos com sigilo (secrecy_level > 0) podem ter informações limitadas ou omitidas dependendo do nível de acesso do usuário.

Próximos Passos

Para trabalhar com objetos lawsuit:
  1. Consulte a documentação de endpoints para ver como buscar processos
  2. Verifique os códigos de erro para tratamento adequado de exceções