Partes do processo

Autores, réus, advogados e demais envolvidos de um processo pelo número CNJ.

Entrada: Número CNJAssíncrona (requestId)

Gerar chave de API

Quando usar

Cadastro de envolvidos

Importe as partes de um processo para o seu sistema sem digitação.

Conflito de interesses

Verifique quem está do outro lado antes de aceitar um caso.

Como funciona

Fluxo assíncrono

Seu sistemaAPI

1POSTCriar consulta
Envia o documento e recebe o requestId na hora.
2GETAcompanhar
Repete a chamada com o requestId enquanto o status for pending.
3GETBuscar partes
Com status done, o resultado completo vem em data.

Como acompanhar o resultado

Repita o GET a cada 2 ou 3 segundos até o status ser done ou error. A maioria das consultas termina em poucos segundos.

Sem cobrança em caso de falha

Se a consulta terminar com erro, o valor volta para o saldo automaticamente.

Passo 1

Criar consulta

POST/api/partner/v2/lawsuits/parties

Cria uma nova consulta para obter as partes (envolvidos) de um processo específico utilizando o número CNJ.

Importante:

O CNJ deve conter apenas números (20 dígitos)
A consulta é processada de forma assíncrona
Use o requestId retornado para acompanhar o progresso
Este endpoint consome créditos do produto LAWSUIT_PARTIES

Corpo da requisição

cnjstringobrigatório
Número CNJ do processo (20 dígitos) - apenas números
instancestringopcional
Grau de jurisdição do processo (opcional)
123

Respostas

200Consulta de partes criada com sucesso
400Erro de validação nos dados enviados
401Erro de autenticação
500Erro interno do servidor

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/lawsuits/parties" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"cnj":"12345678920241000001"}'

Resposta · 200

{
  "requestId": "123e4567-e89b-12d3-a456-426614174000",
  "message": "Solicitação realizada com sucesso"
}

Passo 2

Buscar partes

GET/api/partner/v2/lawsuits/parties/{requestId}

Obtém as partes (envolvidos) de um processo específico baseado na consulta criada anteriormente.

Recursos disponíveis:

Lista completa de partes do processo
Informações detalhadas de cada parte (nome, tipo, polaridade)
Status do processamento da consulta

Status possíveis:

success: Consulta finalizada com sucesso
done: Processamento finalizado (resultados completos)
fetching: Consulta ainda sendo processada
error: Erro no processamento

Parâmetros do caminho

requestIdstringno caminhoobrigatório
ID da solicitação obtido na criação da consulta

Respostas

200Resultados da consulta de partes obtidos com sucesso
400Parâmetros inválidos ou ID não encontrado
401Erro de autenticação
500Erro interno do servidor

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/lawsuits/parties/cm8p1q2r30004ab12cdef5678" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Resposta · 200

{
  "parties": [
    {
      "name": "Maria Oliveira Costa",
      "document": "12345678901",
      "type": "PESSOA_FISICA",
      "isCompany": false,
      "isPartyActive": true,
      "isInferred": false,
      "specificType": "AUTOR",
      "pole": "AUTOR",
      "polarity": "ACTIVE"
    },
    {
      "name": "João da Silva Santos",
      "document": "98765432100",
      "type": "PESSOA_FISICA",
      "isCompany": false,
      "isPartyActive": true,
      "isInferred": false,
      "specificType": "REU",
      "pole": "REU",
      "polarity": "PASSIVE"
    }
  ],
  "status": "success"
}

Próximos passos

Autenticação

Gere a chave e envie no cabeçalho.

Erros e códigos

Como tratar cada resposta de erro.

Cobrança e reembolso

Quando cobramos e quando o valor volta.

Processos por CPF/CNPJ

Todos os processos em que um CPF ou CNPJ aparece, nos tribunais de todo o Brasil, com filtros e paginação.

Processo por CNJ

O processo completo pelo número CNJ, com partes, assuntos, valor da causa e todas as movimentações.

Atualização processual

Busca as movimentações mais recentes de um processo direto no tribunal, sob demanda.