Atualização processual
Busca as movimentações mais recentes de um processo direto no tribunal, sob demanda.
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.
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.
Passo 1
Pedir atualização
/api/partner/v2/lawsuits/updateSolicita 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
requestIdretornado 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
| Campo | Tipo | Descrição |
|---|---|---|
cnjobrigatório | string | Número CNJ do processo, com ou sem máscara Ex.: |
instanceopcional | string | Grau de jurisdição do processo (opcional) 123 |
cnjstringobrigatórioNúmero CNJ do processo, com ou sem máscara
Ex.:
1234567-52.2020.8.26.0100instancestringopcionalGrau 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
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"}'{
"requestId": "cm8p1q2r30004ab12cdef5678",
"message": "Solicitação realizada com sucesso"
}Passo 2
Buscar resultado
/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 tardedone: atualização concluída;datacontém os dados atuais do processoerror: não foi possível concluir; eventual consumo é estornado automaticamente
Parâmetros do caminho
| Campo | Tipo | Descrição |
|---|---|---|
requestIdobrigatório | string | ID retornado ao solicitar a atualização Ex.: |
requestIdstringobrigatórioID retornado ao solicitar a atualização
Ex.:
cmabc123def456
Respostas
- 200Estado atual da solicitação
- 401Erro de autenticação
- 403Acesso negado à solicitação
- 404Request ID não encontrado
- 500Erro interno do servidor
curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/lawsuits/update/cm8p1q2r30004ab12cdef5678" \
-H "Authorization: Bearer SUA_CHAVE_DE_API"{
"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 (48)
| Campo | Tipo | Descrição |
|---|---|---|
status | string | done |
data | object | Dados completos de um processo judicial encontrado na consulta (usuário logado) |
data. | string | Identificador único do processo no sistema Ex.: |
data. | string | Número CNJ completo do processo (padrão: NNNNNNN-DD.AAAA.J.TR.OOOO) Ex.: |
data. | string | Número único do processo (formato: Number-Instance) Ex.: |
data. | string | Grau de jurisdição do processo (1ª instância, 2ª instância, etc.) 123 |
data. | string | Nível do tribunal (mesmo valor do instance) Ex.: |
data. | string | Tipo do processo Ex.: |
data. | string | Área do direito do processo, classificada pelos assuntos e pela classe processual (tabelas do CNJ). É o mesmo valor usado no filtro courtType e em courtTypeTotals. Quando não há sinal suficiente, repete o valor informado pelo tribunal. CIVELCRIMINALTRABALHISTAFAZENDAPREVIDENCIARIAADMINISTRATIVAEx.: |
data. | string | null | Tipo de tribunal exatamente como informado pela fonte. Pode divergir de courtType quando o tribunal classifica errado (ex.: medida protetiva da Lei Maria da Penha informada como CIVEL). |
data. | string | Assunto principal ou classe processual do processo Ex.: |
data. | string | Nome da comarca ou circunscrição judiciária Ex.: |
data. | string | Nome do tribunal Ex.: |
data. | string | Órgão julgador Ex.: |
data. | string | Sigla do estado onde tramita o processo (2 caracteres) Ex.: |
data. | string | Nome da parte requerente (autora) no processo Ex.: |
data. | string | Nome da parte requerida (ré) no processo Ex.: |
data. | string | Polaridade da pessoa consultada no processo ACTIVEPASSIVENEUTRALEx.: |
data. | string | Serviço de hospedagem do processo Ex.: |
data. | string[] | Lista de processos relacionados |
data. | string | Nome do assunto CNJ inferido Ex.: |
data. | string | Número do assunto CNJ inferido Ex.: |
data. | string | Nome do tipo de procedimento CNJ inferido Ex.: |
data. | string | Nome do assunto CNJ amplo inferido Ex.: |
data. | string | Número do assunto CNJ amplo inferido Ex.: |
data. | string[] | Outros assuntos do processo |
data. | number | Valor do processo Ex.: |
data. | string | Data de publicação Ex.: |
data. | string | null | |
data. | string | Data de captura dos dados Ex.: |
data. | string | Data da última atualização Ex.: |
data. | integer | Número de partes no processo Ex.: |
data. | integer | Número de atualizações Ex.: |
data. | integer | Idade do processo em dias Ex.: |
data. | number | Média de atualizações por mês Ex.: |
data. | string | Data de criação do registro Ex.: |
data. | object[] | Lista de partes do processo |
data. | string | Nome da parte |
data. | string | Tipo da parte |
data. | boolean | Se é uma empresa |
data. | boolean | Se a parte está ativa |
data. | boolean | Se foi inferido |
data. | string | Tipo específico |
data. | string | Polo da parte (AUTOR/RÉU) |
data. | object[] | |
data. | string | null | Resumo da situação atual do processo gerado por IA; presente quando includeAiSummary=true Ex.: |
data. | string | Situação da geração do resumo solicitado:
|
data. | integer |
statusstringdonedataobjectDados completos de um processo judicial encontrado na consulta (usuário logado)
data.stringrootLawsuitId Identificador único do processo no sistema
Ex.:
550e8400-e29b-41d4-a716-446655440000data.stringnumber Número CNJ completo do processo (padrão: NNNNNNN-DD.AAAA.J.TR.OOOO)
Ex.:
12345678920241000001data.stringuniqueNumber Número único do processo (formato: Number-Instance)
Ex.:
12345678920241200001-1data.stringinstance Grau de jurisdição do processo (1ª instância, 2ª instância, etc.)
123data.stringcourtLevel Nível do tribunal (mesmo valor do instance)
Ex.:
1data.stringtype Tipo do processo
Ex.:
CIVELdata.stringcourtType Área do direito do processo, classificada pelos assuntos e pela classe processual (tabelas do CNJ). É o mesmo valor usado no filtro courtType e em courtTypeTotals. Quando não há sinal suficiente, repete o valor informado pelo tribunal.
CIVELCRIMINALTRABALHISTAFAZENDAPREVIDENCIARIAADMINISTRATIVAEx.:
CIVELdata.string | nullsourceCourtType Tipo de tribunal exatamente como informado pela fonte. Pode divergir de courtType quando o tribunal classifica errado (ex.: medida protetiva da Lei Maria da Penha informada como CIVEL).
data.stringmainSubject Assunto principal ou classe processual do processo
Ex.:
Indenização por danos morais e materiais decorrentes de acidente de trânsitodata.stringcourtDistrict Nome da comarca ou circunscrição judiciária
Ex.:
São Paulodata.stringcourtName Nome do tribunal
Ex.:
Tribunal de Justiça de São Paulodata.stringjudgingBody Órgão julgador
Ex.:
1ª Vara Cíveldata.stringstate Sigla do estado onde tramita o processo (2 caracteres)
Ex.:
SPdata.stringauthor Nome da parte requerente (autora) no processo
Ex.:
Maria Oliveira Costadata.stringreu Nome da parte requerida (ré) no processo
Ex.:
João da Silva Santosdata.stringdocumentPolarity Polaridade da pessoa consultada no processo
ACTIVEPASSIVENEUTRALEx.:
ACTIVEdata.stringlawsuitHostService Serviço de hospedagem do processo
Ex.:
TJSPdata.string[]relatedLawsuits Lista de processos relacionados
data.stringiCNJSubjectName Nome do assunto CNJ inferido
Ex.:
Indenização por Danos Moraisdata.stringiCNJSubjectNumber Número do assunto CNJ inferido
Ex.:
1000data.stringiCNJProcedureTypeName Nome do tipo de procedimento CNJ inferido
Ex.:
Procedimento Ordináriodata.stringiBroadCNJSubjectName Nome do assunto CNJ amplo inferido
Ex.:
Direito Civildata.stringiBroadCNJSubjectNumber Número do assunto CNJ amplo inferido
Ex.:
1000data.string[]otherSubjects Outros assuntos do processo
data.numbervalue Valor do processo
Ex.:
50000data.stringnoticeDate Data de publicação
Ex.:
2024-01-15T10:30:00Zdata.string | nulllastMovementDate data.stringcaptureDate Data de captura dos dados
Ex.:
2024-01-15T10:30:00Zdata.stringlastUpdate Data da última atualização
Ex.:
2024-01-10T14:30:00Zdata.integernumberOfParties Número de partes no processo
Ex.:
3data.integernumberOfUpdates Número de atualizações
Ex.:
15data.integerlawSuitAge Idade do processo em dias
Ex.:
180data.numberaverageNumberOfUpdatesPerMonth Média de atualizações por mês
Ex.:
2.5data.stringcreatedAt Data de criação do registro
Ex.:
2024-01-15T10:30:00Zdata.object[]parties Lista de partes do processo
data.stringparties[]. name Nome da parte
data.stringparties[]. type Tipo da parte
data.booleanparties[]. isCompany Se é uma empresa
data.booleanparties[]. isPartyActive Se a parte está ativa
data.booleanparties[]. isInferred Se foi inferido
data.stringparties[]. specificType Tipo específico
data.stringparties[]. pole Polo da parte (AUTOR/RÉU)
data.object[]movements data.string | nullaiSummary Resumo da situação atual do processo gerado por IA; presente quando includeAiSummary=true
Ex.:
O processo está em fase de instrução e aguarda manifestação da parte ré.data.stringaiSummaryStatus 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
data.integertotalUpdates
Valores por plano
Sem cobrança em caso de falha
Se a consulta terminar com erro, o valor volta para o saldo automaticamente.
| 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 planosPró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.