Atualização processual

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

Entrada: Número CNJAssíncrona (requestId)

Gerar chave de API Ver preços

Quando usar

Antes de um prazo

Confirme se houve andamento novo antes de uma audiência ou petição.

Processos parados

Force a leitura de um processo que não aparece atualizado há dias.

Conferência pontual

Atualize só o que importa, sem monitorar a carteira inteira.

Como funciona

Fluxo assíncrono

Seu sistemaAPI

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

Pode levar alguns minutos

A atualização consulta o tribunal na hora. Alguns tribunais demoram mais para responder; mantenha o GET até receber done ou error.

Sem cobrança em caso de falha

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

Passo 1

Pedir atualização

POST/api/partner/v2/lawsuits/update

Solicita uma busca em tempo real das informações mais recentes de um processo judicial. O processamento é assíncrono.

Regras importantes:

O CNJ pode ser enviado com ou sem máscara e deve conter 20 dígitos
Use o requestId retornado para acompanhar o processamento
Cada solicitação aceita consome saldo de atualização processual
CNJ inválido, processo restrito, tribunal sem cobertura, monitoramento ativo e cooldown não consomem saldo
Uma falha após o consumo gera estorno automático
Um processo atualizado recentemente respeita a janela de disponibilidade
Enquanto houver uma atualização em andamento, outra não poderá ser criada

Corpo da requisição

cnjstringobrigatório
Número CNJ do processo, com ou sem máscara
instancestringopcional
Grau de jurisdição do processo (opcional)
123

Respostas

200Atualização processual solicitada com sucesso
400CNJ ou instância inválidos
401Erro de autenticação
402Saldo insuficiente ou atualização não habilitada
403Processo restrito por política de privacidade
409Atualização indisponível temporariamente
422Tribunal sem cobertura para atualização automática
500Erro interno do servidor

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/lawsuits/update" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"cnj":"1234567-52.2020.8.26.0100","instance":"1"}'

Resposta · 200

{
  "requestId": "cm8p1q2r30004ab12cdef5678",
  "message": "Solicitação realizada com sucesso"
}

Passo 2

Buscar resultado

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

Consulta o andamento de uma atualização processual.

Status possíveis:

pending: atualização em processamento; consulte novamente mais tarde
done: atualização concluída; data contém os dados atuais do processo
error: não foi possível concluir; eventual consumo é estornado automaticamente

Parâmetros do caminho

requestIdstringno caminhoobrigatório
ID retornado ao solicitar a atualização

Respostas

200Estado atual da solicitação
401Erro de autenticação
403Acesso negado à solicitação
404Request ID não encontrado
500Erro interno do servidor

Requisição

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

Resposta · 200

{
  "status": "done",
  "data": {
    "cnjOnlyNumbers": "12345675220208260100",
    "instance": "1",
    "totalUpdates": 12,
    "lastMovementDate": "2026-07-22T14:30:00.000Z",
    "movements": []
  }
}

O que a resposta traz

Atualização

Situação da atualização
status
Processo atualizado com as movimentações novas
data

Todos os campos da resposta (47)

statusstring
done
dataobject
Dados completos de um processo judicial encontrado na consulta (usuário logado)
data.rootLawsuitIdstring
Identificador único do processo no sistema
data.numberstring
Número CNJ completo do processo (padrão: NNNNNNN-DD.AAAA.J.TR.OOOO)
data.uniqueNumberstring
Número único do processo (formato: Number-Instance)
data.instancestring
Grau de jurisdição do processo (1ª instância, 2ª instância, etc.)
123
data.courtLevelstring
Nível do tribunal (mesmo valor do instance)
data.typestring
Tipo do processo
data.courtTypestring
Classificação do tipo de tribunal onde tramita o processo
CIVELCRIMINALTRABALHISTAFAZENDAPREVIDENCIARIAADMINISTRATIVA
data.mainSubjectstring
Assunto principal ou classe processual do processo
data.courtDistrictstring
Nome da comarca ou circunscrição judiciária
data.courtNamestring
Nome do tribunal
data.judgingBodystring
Órgão julgador
data.statestring
Sigla do estado onde tramita o processo (2 caracteres)
data.authorstring
Nome da parte requerente (autora) no processo
data.reustring
Nome da parte requerida (ré) no processo
data.documentPolaritystring
Polaridade da pessoa consultada no processo
ACTIVEPASSIVENEUTRAL
data.lawsuitHostServicestring
Serviço de hospedagem do processo
data.relatedLawsuitsstring[]
Lista de processos relacionados
data.iCNJSubjectNamestring
Nome do assunto CNJ inferido
data.iCNJSubjectNumberstring
Número do assunto CNJ inferido
data.iCNJProcedureTypeNamestring
Nome do tipo de procedimento CNJ inferido
data.iBroadCNJSubjectNamestring
Nome do assunto CNJ amplo inferido
data.iBroadCNJSubjectNumberstring
Número do assunto CNJ amplo inferido
data.otherSubjectsstring[]
Outros assuntos do processo
data.valuenumber
Valor do processo
data.noticeDatestring
Data de publicação
data.lastMovementDatestring | null
data.captureDatestring
Data de captura dos dados
data.lastUpdatestring
Data da última atualização
data.numberOfPartiesinteger
Número de partes no processo
data.numberOfUpdatesinteger
Número de atualizações
data.lawSuitAgeinteger
Idade do processo em dias
data.averageNumberOfUpdatesPerMonthnumber
Média de atualizações por mês
data.createdAtstring
Data de criação do registro
data.partiesobject[]
Lista de partes do processo
data.parties[].namestring
Nome da parte
data.parties[].typestring
Tipo da parte
data.parties[].isCompanyboolean
Se é uma empresa
data.parties[].isPartyActiveboolean
Se a parte está ativa
data.parties[].isInferredboolean
Se foi inferido
data.parties[].specificTypestring
Tipo específico
data.parties[].polestring
Polo da parte (AUTOR/RÉU)
data.movementsobject[]
data.aiSummarystring | null
Resumo da situação atual do processo gerado por IA; presente quando includeAiSummary=true
data.aiSummaryStatusstring
Situação da geração do resumo solicitado: - **complete**: resumo incluído - **unavailable**: não foi possível gerar o resumo deste processo - **limit_reached**: fora dos resumos permitidos pelo contrato ou limite mensal atingido
completeunavailablelimit_reached
data.totalUpdatesinteger

Valores por plano

Plano mensal	Valor da consulta
Sob demanda	R$ 6,90
R$ 100/mês até 31 atualizações	R$ 3,20
R$ 300/mês até 115 atualizações	R$ 2,60
R$ 500/mês até 212 atualizações	R$ 2,35
R$ 1.000/mês até 476 atualizações	R$ 2,10
R$ 3.000/mês até 1.666 atualizações	R$ 1,80
R$ 10.000/mês até 6.250 atualizações	R$ 1,60
R$ 20.000/mês até 13.333 atualizações	R$ 1,50

O valor é cobrado por atualização, na criação da consulta. Ler o resultado de novo pelo mesmo requestId não gera nova cobrança.

Sem plano, a conta usa o valor Sob demanda e paga só o que consumir.

Comparar planos

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.

Partes do processo

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