Documentação Técnica

Processos Judiciais e Administrativos de Familiares de Primeiro Nível

Descrição

O dataset de Processos Judiciais e Administrativos de Familiares de Primeiro Nível retorna informações análogas ao dataset de Processos Judiciais e Administrativos, mas relacionadas com os familiares de primeiro nível - mãe, pai, irmãos, filhos - do indivíduo consultado. O objetivo deste dataset é simplificar o processo de consulta dos nossos clientes, possibilitando a verificação de informações de múltiplos CPFs em uma única requisição.

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,190
10001 - 50000R$ 0,180
50001 - 100000R$ 0,171
100001 - 500000R$ 0,162
500001 - 1000000R$ 0,154
1000001 - 5000000R$ 125,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
birthdateData de Nascimentoyyyy-MM-ddℹ️  Opcional
dateformatFormato da Datayyyy-MM-dd, dd/MM/yyyyℹ️  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": "first_level_relatives_lawsuit_data",
    "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.
courttypeTipo do TribunalIgualCIVEL, CRIMINAL, TRIBUTARIA, PREVIDENCIARIA, TRABALHISTA, ESPECIAL CIVEL, ESPECIAL CRIMINAL, ADMINISTRATIVA, ELEITORAL, FAZENDA, ESPECIAL FAZENDA
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": "first_level_relatives_lawsuit_data.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(courttype=[criminal],partytype=[inmate,defendant])"
}
Nesse caso, o filtro será aplicado a todos os processos judiciais que forem do tipo (courttype) "criminal" 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": "first_level_relatives_lawsuit_data.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": "first_level_relatives_lawsuit_data.order(LastMovementDate=descending)",
    "q": "doc{CPF}"  
}  

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: O 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: O 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
Credentials
Click Try It! to start a request and see the response here!