Documentação Técnica

Processos Judiciais e Administrativos

Descrição

O dataset de Processos Judiciais e Administrativos retorna informações, tanto atuais quanto históricas, do envolvimento da entidade consultada em ações judiciais de todos os tipos (civil, trabalhista, criminal, etc.), bem como informações relacionadas a processos de perfil administrativo, geralmente movidos por/em órgãos regulatórios ou entidades de classe específicas. Além de informações resumidas, como a quantidade total de processos em que a entidade está envolvida, são retornadas informações detalhadas sobre cada um dos processos, como a lista das partes, as movimentações ocorridas ao longo do tempo e outros detalhes relevantes.
As entidades são associadas aos processos judiciais de 3 formas distintas: no caso das partes (sejam indivíduos ou empresas), é realizada tanto a associação por documento, quando o documento de identificação consta do processo, quanto por nome, quando o nome é único o suficiente para permitir esse tipo de associação. Outros tipos de partes (advogados, peritos, etc.) são associadas através de seus documentos de identificação específicos, como o número de registro na OAB.

Origem da Informação

Todas as informações deste dataset têm como origem os diferentes tribunais de justiça espalhados pelo Brasil.

Tabela de preços para esse dataset

Consultas Realizadas no MêsValor por consulta
1 - 10000R$ 0,070
10001 - 50000R$ 0,066
50001 - 100000R$ 0,063
100001 - 500000R$ 0,060
500001 - 1000000R$ 0,057
1000001 - 5000000R$ 46.000,00 (preço fixo)
5000001 e acimaEntre em contato

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

CampoDescriçãoValores PossíveisTipo de Campo
docDocumento de identificaçãoCPF🛑 Obrigatório
returnupdatesIndica se as listas de updates dos processos devem ser retornados. Caso seja definido como "false", irá reduzir consideravelmente o tamanho do resultado, aprimorando a performance da consulta.true, falseℹ️  Opcional
returncvmprocessesSe este parâmetro for definido como "true" e forem encontrados processos cuja corte seja a CVM, os processos serão adicionados ao início da lista de lawsuits. Os processos da CVM possuem um numeração diferente e alguns dos campos, como CourtLevel e CoutType, não são retornados.true, falseℹ️  Opcional
updateslimitNúmero que determina o limite máximo de retorno das atualizações dos processos judiciais. Se for definido, apenas as atualizações mais recentes são retornados, de acordo com este limite.Númeroℹ️  Opcional

Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.

Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:

{  
    "Datasets": "processes",
    "q": "doc{CPF}"  
}  

Filtros

CampoDescrição do filtroTipo do filtroValores Possíveis do Filtro
capturedateData de captura do processoEntre (Necessita de dois valores)[yyyy-MM-dd, yyyy-MM-dd]
closedateData de fechamento do processoEntre[yyyy-MM-dd, yyyy-MM-dd]
cnjsubjectNúmero ou nome do assunto no CNJ. Quando usados valores númericos, este filtro abrange os campos InferredCNJSubjectNumber e InferredBroadCNJSubjectNumber. Em caso de valores de texto, aplica-se aos campos InferredCNJSubjectName e InferredBroadCNJSubjectName.IgualNúmero ou texto
cnjproceduretypeNúmero ou nome do tipo do processo no CNJ. Quando forem informados números, o filtro é aplicado ao campo InferredCNJProcedureTypeNumber, e caso sejam textos, aplica-se ao campo InferredCNJProcedureTypeName.IgualNúmero ou texto
courtlevelNivel do tribunalIgual1, 2, 3
courtnameNome do TribunalIgualSTF, STJ, TRF1, JFAC, JFAM, JFAP, JFBA, JFDF, JFGO, JFMA, JFMG, JFMT, JFPA, JFPI, JFRO, JFRR, JFTO, TRF2, JFES, JFRJ, TRF3, JFMS, JFSP, TRF4, JFPR, JFRS, JFSC, TRF5, JFAL, JFCE, JFPB, JFPE, JFRN, JFSE, TRF6, TJAC, TJAL, TJAM, TJAP, TJBA, TJCE, TJDF, TJES, TJGO, TJMA, TJMG, TJMS, TJMT, TJPA, TJPB, TJPE, TJPI, TJPR, TJRJ, TJRN, TJRO, TJRR, TJRS, TJSC, TJSE, TJSP, TJTO, TRT1, TRT2, TRT3, TRT4, TRT5, TRT6, TRT7, TRT8, TRT9, TRT10, TRT11, TRT12, TRT13, TRT14, TRT15, TRT16, TRT17, TRT18, TRT19, TRT20, TRT21, TRT22, TRT23, TRT24, TST, TRE-AC, TRE-AL, TRE-AM, TRE-AP, TRE-BA, TRE-CE, TRE-DF, TRE-ES, TRE-GO, TRE-MA, TRE-MG, TRE-MS, TRE-MT, TRE-PA, TRE-PB, TRE-PE, TRE-PI, TRE-PR, TRE-RJ, TRE-RN, TRE-RO, TRE-RR, TRE-RS, TRE-SC, TRE-SE, TRE-SP, TRE-TO, TSE.
partypolarityPolaridade da parteIgualACTIVE, PASSIVE, NEUTRAL
partytypeTipo da parteIgualAUTHOR, DEFENDANT, CLAIMANT, CLAIMED, LAWYER, REPORTER, ATTORNEY, WITNESS, VICTIM, JUDGE, INMATE, OTHER
noticedateData de notificação do processoEntre[yyyy-MM-dd, yyyy-MM-dd]
stateEstadoIgualRJ, SP, MG, ES, etc.
statusStatus do processoContémAtivo, Distribuído, Baixado, Apenso, Decidido, Autuado, Execução, Finalizado, Encerrado, Em Grau de Recurso, Redistribuído, Transitado em Julgado, Arquivado, Julgado, Indefinido
resjudicatadateData de Res JuldicataEntre[yyyy-MM-dd, yyyy-MM-dd]
valueValor disputado no processoEntre[Mínimo, Máximo]

Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)

{  
    "Datasets": "processes.filter(capturedate=[yyyy-MM-dd, yyyy-MM-dd])",
    "q": "doc{CPF}"  
}  

É possível utilizar múltiplos filtros em conjunto para especificar com maiores detalhes o refino da busca.
Abaixo está um exemplo de como utilizar o parâmetro de filtro:

{
"Datasets": "processes.filter(courtlevel=[1],partytype=[inmate,defendant])"
}
Nesse caso, o filtro será aplicado a todos os processos judiciais que forem do nível (courtlevel) "1" E que a pessoa pesquisada se enquadre em UMA DAS seguintes partes do processo (partytype) "Inmate" OU "Defendant".

Atenção: Por razões de performance, em consultas com mais de 10.000 processos judiciais, os filtros são aplicados aos resultados limitados da página da consulta. Desse modo, as páginas entregues podem não ter o tamanho esperado. Portanto, para obter todos os resultados do filtro, é necessário que seja feita a paginação da consulta, que pode ser feita normalmente sempre que for retornado o campo NextPageId. Lembrando que, a paginação das consultas não é cobrada.

Limite

Para utilizar o campo de limite basta utilizar o parâmetro .limit(x)

{  
    "Datasets": "processes.limit(10)",
    "q": "doc{CPF}"  
}  

Ordenação

É possível ordenar os resultados de retorno da lista principal. Para isso, basta utilizar o parâmetro .order(campo_na_lista=ascending/descending)

Abaixo estão os campos aceitos para a ordenação:

Campo
LastMovementDate
NoticeDate
CloseDate
ResJudicataDate
CaptureDate
Value
{  
    "Datasets": "processes.order(LastMovementDate=descending)",
    "q": "doc{CPF}"  
}  

Paginação

A paginação do dataset pode ser feita através do parâmetro .next(x), utilizando o ID retornado pela requisição anterior e um parâmetro de consulta q com o mesmo parâmetro inserido na consulta original, conforme o exemplo abaixo:

{  
    "Datasets": "processes.next(Id da próxima página)",
    "q": "doc{CPF}"  
}  

As chamadas de paginação não tem custo adicional para o cliente final. Se uma entidade tiver 100 processos associados, e você fizer uma requisição para pegar os primeiros 10 processos e mais nove requisições para pegar o restante, só vai pagar a primeira requisição. Após a chamada inicial, você tem até 3 horas para realizar uma operação de paginação. Depois disso, as páginas não estarão mais disponíveis para consulta, e o processo terá de ser iniciado novamente.

Descrição dos campos do objeto principal de retorno

CampoDescrição
LawsuitsLista contendo todos os processos relacionados ao documento consultado e que atendam aos filtros especificados
TotalLawsuitsNúmero total de processos judiciais da entidade consultada
TotalLawsuitsAsAuthorNúmero de processos em que a entidade consultada é uma parte ativa, tendo o tipo de parte igual a AUTHOR, CLAIMANT, LITS ATIVO ou PACIENTE
TotalLawsuitsAsDefendantNúmero de processos em que a entidade consultada é uma parte passiva, tendo o tipo de parte igual a DEFENDANT, CLAIMED ou LITS PASSIVO
TotalLawsuitsAsOtherNúmero de processos em que a entidade consultada possui tipo de parte diferente dos citados nos dois campos anteriores
FirstLawsuitDateData de abertura do primeiro processo judicial relacionado à entidade consultada
LastLawsuitDateData de abertura do último processo judicial relacionado à entidade consultada

Seleção de campos dentro dos sub-objetos

Além de selecionar os campos do objeto principal de retorno, como é possível em todos os datasets, este dataset permite, também, a seleção de campos específicos dentro dos processos individuais retornados pela pesquisa. Qualquer um dos campos pode ser selecionado, e múltiplos campos podem ser combinados em uma única chamada. Assim, é possível solicitar apenas os números dos processos relacionados com uma entidade (ao invés do conteúdo completo), ou apenas o tipo do processo.

Polaridade das partes

Classificamos todas as partes como ACTIVE, PASSIVE e NEUTRAL, de acordo com a natureza de sua participação no processo.
ACTIVE: polo ativo do processo. De forma geral, a parte que abre o processo, isto é, a parte que submete um pedido a ser analisado pelo judiciário. Ex.: Autor, Requerente, Reclamante, Exequente.
PASSIVE: polo passivo do processo. De forma geral, a parte contra quem se abre o processo, isto é, a parte a quem será imposta uma obrigação, caso o pedido da parte ativa seja considerado procedente. Ex.: Réu, Requerido, Reclamado, Executado.
NEUTRAL: Todas as partes que não se encaixam nas definições acima. Ex.: Relator, Advogado, Procurador, Terceiro Interessado.

Language
Authorization
Click Try It! to start a request and see the response here!