Processos Judiciais — Totalizador e Lista PJ

Retorna, em uma única chamada, os dados cadastrais, o totalizador estatístico e a lista completa de processos judiciais de uma pessoa jurídica a partir do CNPJ. Aceita os mesmos filtros do endpoint Processos CNPJ (status do polo, status processual, ramo do direito, tribunal, segmento, grau do processo, período de distribuição e valor da causa) para refinar a lista de processos.

Para uma visão estatística mais rápida (sem a lista), use apenas o Totalizador (/totalizadorprocessos).

Indicada para due diligence, análise de crédito, compliance e verificação de litígios antes de contratações, parcerias e negociações.

TABELA DE CAMPOS DE REQUISIÇÃO

Campo	Descrição	Formato	Obrigatório
IdConsulta	Identificador da consulta. Valor fixo: `781`.	string	Sim
CpfCnpj	CNPJ a ser consultado.	string	Sim
NomeRazao	Razão social (opcional). Pode ser enviado como `null` ou omitido.	string	Não
TipoPessoa	Tipo de pessoa. Valor fixo: `J`.	string	Sim
Filtros.StatusPolo	Filtra pela posição do titular no processo. Ver códigos na página Processos Judiciais.	string	Não
Filtros.StatusProcessuais	Filtra por status processual. Ver códigos na página Processos Judiciais. Aceita múltiplos valores.	array de string	Não
Filtros.RamosDoDireito	Filtra por ramo do direito. Ver códigos na página Processos Judiciais. Aceita múltiplos valores.	array de string	Não
Filtros.Tribunais	Filtra por sigla do tribunal (ex: `TJ-SP`). Aceita múltiplos valores.	array de string	Não
Filtros.Segmentos	Filtra por segmento de justiça. Ver códigos na página Processos Judiciais. Aceita múltiplos valores.	array de string	Não
Filtros.GrausProcesso	Filtra por grau do processo. Ver códigos na página Processos Judiciais. Aceita múltiplos valores.	array de string	Não
Filtros.DataDistribuicaoDe	Data inicial de distribuição do processo.	`DD/MM/AAAA`	Não
Filtros.DataDistribuicaoAte	Data final de distribuição do processo.	`DD/MM/AAAA`	Não
Filtros.ValorCausaDe	Valor mínimo da causa.	number	Não
Filtros.ValorCausaAte	Valor máximo da causa.	number	Não

Os códigos de cada filtro (Status Polo, Status Processual, Ramo do Direito, Segmentos e Grau do Processo) estão na seção Filtros da Lista de Processos da página Processos Judiciais.

TABELA DE CAMPOS DE RETORNO

Cabeçalho da Resposta — CONSULTA

Campo	Descrição	Formato
CONSULTA.CODIGORESPOSTA	Código interno da transação.	string
CONSULTA.DATAHORA	Data e hora da consulta.	`DD/MM/YYYY HH:MM:SS`
CONSULTA.LOGON	Identificador da conta que realizou a consulta.	string
CONSULTA.IDCONSULTA	IdConsulta enviado na requisição.	string
RESPOSTA.CODIGO	Array com o código de cada integração, na ordem `[DADOSCADASTRAIS, PROCESSOS_TOTALIZADOR, PROCESSOS_LISTA]` (`1` = sucesso, `2` = não encontrado, `3` = erro).	array

🏢 Dados Cadastrais — DADOSCADASTRAIS

Campo	Descrição	Formato
RESPOSTA.DADOSCADASTRAIS.CPFCNPJ	CNPJ da empresa consultada.	string
RESPOSTA.DADOSCADASTRAIS.NOMERAZAO	Razão social da empresa.	string
RESPOSTA.DADOSCADASTRAIS.NASCFUND	Data de fundação da empresa.	`DD/MM/YYYY`
RESPOSTA.DADOSCADASTRAIS.NOMEFANTASIA	Nome fantasia da empresa.	string
RESPOSTA.DADOSCADASTRAIS.CODIGONATUREZA	Código da natureza jurídica.	string
RESPOSTA.DADOSCADASTRAIS.DESCNATUREZA	Descrição da natureza jurídica.	string

Quando o CNPJ não é localizado na base cadastral, DADOSCADASTRAIS retorna vazio ("") e o código da primeira posição de RESPOSTA.CODIGO vem como 2; os blocos de processos continuam sendo retornados.

📊 Processos Judiciais (Totalizador) — PROCESSOS_TOTALIZADOR

Campo	Descrição	Formato
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.CONTAGEM	Quantidade total de processos encontrados.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.CIVEL	Quantidade de processos na área cível.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.TRABALHISTA	Quantidade de processos na área trabalhista.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.CRIMINAL	Quantidade de processos na área criminal.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.FISCAL	Quantidade de processos na área fiscal.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.NULOS	Quantidade de processos sem área identificada.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.OUTROS	Quantidade de processos em outras áreas.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.TRIBUNAIS.REGISTRO_N.NOME	Sigla do tribunal (ex: `TJ-SP`).	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.TRIBUNAIS.REGISTRO_N.QUANTIDADE	Quantidade de processos no tribunal.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.DISTRIBUICAOPORANO.REGISTRO_N.ANOREFERENCIA	Ano de distribuição.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.DISTRIBUICAOPORANO.REGISTRO_N.QUANTIDADE	Quantidade de processos distribuídos no ano.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.SEGMENTOS.REGISTRO_N.NOME	Segmento de justiça (ex: `JUSTICA ESTADUAL`).	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.SEGMENTOS.REGISTRO_N.QUANTIDADE	Quantidade de processos no segmento.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.RAMODIREITO.ATIVOS/PASSIVOS/OUTROS.REGISTRO_N.NOME	Ramo do direito, separado pelo polo do consultado no processo.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.RAMODIREITO.ATIVOS/PASSIVOS/OUTROS.REGISTRO_N.TOTALPROCESSOS	Quantidade de processos no ramo do direito e polo.	string
RESPOSTA.PROCESSOS_TOTALIZADOR.DATA.RAMODIREITO.ATIVOS/PASSIVOS/OUTROS.REGISTRO_N.TOTALVALORCAUSA	Soma do valor da causa no ramo do direito e polo.	string

⚖️ Processo — Dados Gerais (DATA.REGISTRO_N)

Campo	Descrição	Formato
RESPOSTA.PROCESSOS_LISTA.DATA.CONTAGEM	Quantidade de processos retornados nesta busca (após filtros).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.NUMEROPROCESSOUNICO	Número único do processo (CNJ).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.NUMEROPROCESSOANTIGO	Número antigo do processo (formato anterior ao padrão CNJ), quando houver.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.URLPROCESSO	URL de consulta pública do processo no tribunal de origem.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.STATUSOBSERVACAO	Situação resumida do processo (ex: `EXTINTO`, `ENCERRADO`, `SUSPENSO`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.GRAUPROCESSO	Grau do processo. Ver tabela de códigos acima.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.JUIZ	Nome do juiz responsável, quando disponível.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.RELATOR	Nome do relator, em processos de grau recursal.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.TRIBUNALORIGEM	Tribunal de origem do processo, em processos de grau recursal.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.REVISORES.REGISTRO_N	Nomes dos revisores, em processos de grau recursal.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.AREA	Área do processo (ex: `CIVEL`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.SISTEMA	Sistema processual de origem (ex: `ESAJ-TJSP`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.SEGMENTO	Segmento de justiça.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.TRIBUNAL	Sigla do tribunal.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.UF	UF do tribunal.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ORGAOJULGADOR	Vara/câmara responsável pelo processo.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.UNIDADEORIGEM	Unidade/foro de origem do processo.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.CLASSEPROCESSUAL.NOME	Classe processual.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.CLASSEPROCESSUAL.CODIGOCNJ	Código CNJ da classe processual.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ASSUNTOSCNJ.REGISTRO_N.TITULO	Assunto CNJ do processo.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ASSUNTOSCNJ.REGISTRO_N.CODIGOCNJ	Código CNJ do assunto.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ASSUNTOSCNJ.REGISTRO_N.EPRINCIPAL	`1` quando é o assunto principal do processo.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.DATADISTRIBUICAO	Data de distribuição do processo.	`YYYY-MM-DDTHH:MM:SS`
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.DATAAUTUACAO	Data de autuação do processo.	`YYYY-MM-DDTHH:MM:SS`
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.VALORCAUSA.MOEDA	Moeda do valor da causa.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.VALORCAUSA.VALOR	Valor da causa.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ETUTELAANTECIPADA	`1` quando há tutela antecipada.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.EJUSTICAGRATUITA	`1` quando há justiça gratuita concedida.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.EPRIORITARIO	`1` quando o processo tem prioridade de tramitação.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ESEGREDOJUSTICA	`1` quando o processo corre em segredo de justiça.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.EPROCESSODIGITAL	`1` quando o processo é digital.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.DATAPROCESSAMENTO	Data em que a fonte processou/atualizou este registro.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PROCESSOSRELACIONADOS.REGISTRO_N.NUMEROPROCESSO	Número de processos relacionados (apensos, recursos, execuções).	string

👥 Processo — Partes e Advogados (PARTES)

Campo	Descrição	Formato
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.TIPO	Papel da parte no processo (ex: `EXEQUENTE`, `EXECUTADA`, `REU`, `AUTOR`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.NOME	Nome da parte.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.POLO	Polo da parte: `ATIVO`, `PASSIVO` ou vazio.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.CPF	CPF da parte, quando pessoa física.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.CNPJ	CNPJ da parte, quando pessoa jurídica.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.CNPJRAIZ	Raiz do CNPJ da parte.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ORIGEMDOCUMENTO	Origem do vínculo da parte ao processo (`TRIBUNAL` ou `AGREGADO`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.DATAATUALIZACAO	Data da última atualização da parte.	`YYYY-MM-DD`
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.NOME	Nome do advogado da parte.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.TIPO	Tipo do representante (ex: `ADVOGADO`, `ADVOGADA`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.CPF	CPF do advogado.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.OAB.UF	UF da OAB do advogado.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.OAB.NUMERO	Número de inscrição na OAB.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.OAB.TIPO	Tipo da inscrição na OAB.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.PARTES.REGISTRO_N.ADVOGADOS.REGISTRO_N.DATAATUALIZACAO	Data da última atualização do advogado.	`YYYY-MM-DD`

📌 Processo — Situação Processual (ANALISEPROCESSUAL)

Campo	Descrição	Formato
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.STATUSPROCESSO	Status processual consolidado (ex: `ARQUIVAMENTO DEFINITIVO`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.RAMODIREITO	Ramo do direito do processo.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.PENHORAS	Informações de penhora, quando houver.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.DATAARQUIVAMENTO	Data de arquivamento do processo, quando houver.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.DATATRANSITOJULGADO	Data do trânsito em julgado, quando houver.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.JUSTICAGRATUITA	Situação da justiça gratuita no processo (ex: `DEFERIDA`), quando houver.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.VALOREXECUCAO.VALOR	Valor em execução, quando houver.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.JULGAMENTOS.REGISTRO_N.DATAJULGAMENTO	Data do julgamento.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.JULGAMENTOS.REGISTRO_N.TIPOJULGAMENTO	Tipo do julgamento (ex: `EXTINTA`, `PROCEDENTE`).	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.JULGAMENTOS.REGISTRO_N.STATUSJULGAMENTO	Detalhamento do resultado do julgamento.	string
RESPOSTA.PROCESSOS_LISTA.DATA.REGISTRO_N.ANALISEPROCESSUAL.JULGAMENTOS.REGISTRO_N.DIASATEJULGAMENTO	Quantidade de dias entre a distribuição e o julgamento.	string

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

Objeto de consulta com o CNPJ da empresa e os filtros opcionais.

ConsultaobjectRequired

Response

Resposta da consulta:

Código ["1","1","1"]: Sucesso — dados cadastrais, totalizador e lista de processos retornados.
Código 2 em uma posição (ex: ["2","1","1"]): dado não encontrado naquela integração — por exemplo, CNPJ ausente da base cadastral, com os processos retornados normalmente.
Código 3: Erro na consulta.

CONSULTAobjectOptional

RESPOSTAobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error