Processo por CNJ

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

Entrada: Número CNJResposta imediata

Gerar chave de API Ver preços

Quando usar

Acompanhamento de carteira

Traga os dados atualizados de um processo que você já conhece.

Enriquecimento de cadastro

Complete partes, classe, assunto e valor da causa no seu sistema.

Leitura de andamentos

Use as movimentações para alimentar prazos e alertas internos.

Como funciona

Fluxo síncrono

Seu sistemaAPI

1POSTConsultar processo
Envia o número e recebe o resultado completo na mesma resposta.
2GETPaginar movimentações
Usa o requestId para buscar mais páginas sem nova cobrança.

Resposta imediata

O POST já devolve o processo completo. O requestId serve para paginar as movimentações sem nova cobrança.

Sem cobrança em caso de falha

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

Passo 1

Consultar processo

POST/api/partner/v2/lawsuits/cnj

Realiza uma consulta síncrona de um processo judicial pelo número CNJ e retorna os dados completos com todas as movimentações disponíveis.

Importante:

O CNJ pode ser enviado com ou sem máscara
O CNJ deve conter 20 dígitos
O resultado é retornado diretamente e inclui um requestId
Use o requestId para consultar páginas adicionais de movimentações sem uma nova cobrança
Cada chamada consome saldo do produto LAWSUIT_SEARCH_CNJ como uma nova consulta por CNJ
O campo movements contém todas as movimentações disponíveis agrupadas por data

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

200Processo consultado com sucesso
400Erro de validação nos dados enviados
401Erro de autenticação
402Saldo insuficiente
403Consulta bloqueada por política de privacidade
500Erro interno do servidor

Requisição

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

Resposta · 200

{
  "status": "done",
  "requestId": "cm7q4w2xk0001l508efgh5678",
  "data": {
    "rootLawsuitId": "cm4k2x9vb0003l708abcd1234",
    "cnjMasked": "1001234-56.2023.8.26.0100",
    "cnjOnlyNumbers": "10012345620238260100",
    "instance": "1",
    "type": "PROCEDIMENTO COMUM",
    "classe": "PROCEDIMENTO COMUM",
    "courtType": "CIVEL",
    "mainSubject": "Indenização por Dano Moral",
    "otherSubjects": [
      "Indenização por Dano Moral",
      "Responsabilidade Civil"
    ],
    "iCNJSubjectName": "Indenização por Dano Moral",
    "iCNJProcedureTypeName": "Procedimento Comum Cível",
    "iBroadCNJSubjectName": "DIREITO CIVIL",
    "courtName": "TJSP",
    "courtDistrict": "São Paulo",
    "forum": "São Paulo",
    "state": "SP",
    "judge": "5ª Vara Cível do Foro Central",
    "value": "50000",
    "status": "ATIVO",
    "sealed": false,
    "author": "Maria Oliveira Costa",
    "reu": "Empresa Exemplo Ltda",
    "parties": [
      {
        "name": "Maria Oliveira Costa",
        "type": "CLAIMANT",
        "specificType": "",
        "pole": "ACTIVE",
        "document": "12345678901",
        "maskedDocument": "123.XXX.XXX-XX",
        "isCompany": false,
        "isPartyActive": true,
        "isInferred": false
      },
      {
        "name": "Empresa Exemplo Ltda",
        "type": "CLAIMED",
        "specificType": "",
        "pole": "PASSIVE",
        "document": "12345678000190",
        "isCompany": true,
        "isPartyActive": true,
        "isInferred": false
      },
      {
        "name": "João Pereira",
        "type": "LAWYER",
        "specificType": "",
        "pole": "NEUTRAL",
        "oab": "SP123456",
        "isCompany": false,
        "isPartyActive": true,
        "isInferred": false
      }
    ],
    "relatedLawsuits": [
      {
        "id": "cm5a8b1cd0007l808ijkl9012",
        "cnjMasked": "1001234-56.2023.8.26.0100",
        "instance": "2"
      }
    ],
    "noticeDate": "2023-03-14T00:00:00.000Z",
    "publicationDate": "2023-03-15T00:00:00.000Z",
    "lastMovementDate": "2024-09-02 14:30",
    "totalUpdates": 37,
    "movements": [
      {
        "date": "2024-09-02 14:30",
        "updates": [
          {
            "title": "Conclusos para sentença",
            "description": "",
            "date": "2024-09-02T14:30:00.000Z",
            "iaExplanation": "",
            "files": []
          }
        ]
      },
      {
        "date": "2024-08-20 10:12",
        "updates": [
          {
            "title": "Juntada de petição",
            "description": "Petição de manifestação sobre a contestação",
            "date": "2024-08-20T10:12:00.000Z",
            "iaExplanation": "",
            "files": [
              {
                "id": "doc_8f3a21",
                "type": "Petição",
                "name": "Manifestação",
                "pages": 4,
                "filedAt": "2024-08-20T10:12:00.000Z",
                "signers": [
                  "João Pereira"
                ]
              },
              {
                "kind": "attachment",
                "id": "5521",
                "description": "Petição de manifestação",
                "fileExtension": "pdf",
                "href": "https://consultadeprocessos.com.br/api/partner/v2/files/aHR0cHM6Ly9leGVtcGxv.k3Jd9Qx"
              }
            ]
          }
        ]
      }
    ]
  }
}

Passo 2

Paginar movimentações

GET/api/partner/v2/lawsuits/cnj/{requestId}/movements

Retorna as movimentações da consulta por CNJ em páginas de 20 itens, sem consumir uma nova consulta. O requestId é devolvido pelo endpoint POST /api/partner/v2/lawsuits/cnj.

Apenas o usuário que realizou a consulta original pode acessar suas movimentações.

Parâmetros do caminho

requestIdstringno caminhoobrigatório
Identificador retornado na consulta por CNJ

Parâmetros de consulta

pageintegerqueryopcional
Página de movimentações

Respostas

200Página de movimentações retornada com sucesso
400Número da página inválido
401Erro de autenticação
403Acesso negado ao requestId
404Consulta ou processo não encontrado
409Consulta original ainda não concluída
500Erro interno do servidor

Campos da resposta (15)

statusstring
done
requestIdstring
dataobject
data.cnjOnlyNumbersstring
data.instancestring
data.totalUpdatesinteger
Total conhecido de movimentações do processo
data.lastMovementDatestring | null
data.movementsobject[]
data.paginationobject
data.pagination.currentPageinteger
data.pagination.totalPagesinteger
data.pagination.hasNextPageboolean
data.pagination.hasPreviousPageboolean
data.pagination.totalItemsinteger
Total de movimentações materializadas
data.hasMoreUpdatesToFetchboolean
Indica que o total conhecido é maior que o materializado

Requisição

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

Resposta · 200

{
  "status": "done",
  "requestId": "cmabc123def456",
  "data": {
    "cnjOnlyNumbers": "00412042420248160014",
    "instance": "1",
    "totalUpdates": 179,
    "lastMovementDate": "2026-07-27 12:00",
    "movements": [],
    "pagination": {
      "currentPage": 1,
      "totalPages": 9,
      "hasNextPage": true,
      "hasPreviousPage": false,
      "totalItems": 176
    },
    "hasMoreUpdatesToFetch": true
  }
}

O que a resposta traz

Identificação do processo

Número CNJ
cnjMasked · cnjOnlyNumbers
Formatado e só com dígitos.
Instância
instance
1, 2 ou 3.
Tribunal, comarca e UF
courtName · courtDistrict · state
Órgão julgador
judge
Vara, turma ou câmara onde o processo tramita.
Processos relacionados
relatedLawsuits[]
O mesmo número em outras instâncias.
Segredo de justiça
sealed
Quando true, o processo não recebe mais atualizações.

Assunto, classe e valor

Assunto principal e demais assuntos
mainSubject · otherSubjects
Classe processual
type
Ex.: procedimento comum, execução fiscal, ação penal.
Área do direito
courtType
Cível, trabalhista, criminal, previdenciária, tributária etc.
Classificação pela tabela do CNJ
iCNJSubjectName · iCNJProcedureTypeName · iBroadCNJSubjectName
Assunto, procedimento e ramo do direito padronizados.
Valor da causa
value
Texto com o valor em reais; "-1" quando não informado.
Situação
status
Ativo, arquivado, suspenso, transitado em julgado etc.

Partes

Autor e réu
author · reu
Nome principal de cada polo.
Todas as partes
parties[]
Nome, papel (autor, réu, advogado, testemunha...), polo e se é empresa.
Documento e OAB
document · maskedDocument · oab
CPF/CNPJ quando disponível, a versão mascarada publicada pelo tribunal e a OAB do advogado.

Datas

Data de distribuição
noticeDate
Data de publicação
publicationDate
Última movimentação
lastMovementDate
No formato AAAA-MM-DD HH:mm.

Movimentações e documentos

Movimentações agrupadas por data
movements[]
Cada grupo traz a data e os andamentos com título, descrição e data.
Quantidade de movimentações
totalUpdates
Documentos da movimentação
movements[].updates[].files[]
Tipo, nome, data de juntada, páginas e signatários. Anexos vêm com href para download pela API, com a mesma chave.
Paginação das movimentações
pagination
Páginas de 20 andamentos pelo requestId, sem nova cobrança.
Lista completa de documentos do processoSó no painel
Publicações do Diário de JustiçaSó no painel

Resumo por IA

Situação atual resumida por IASó no painel
Chat com o processoSó no painel

Valores por plano

Plano mensal	Valor da consulta
Sob demanda	R$ 2,90
R$ 100/mês até 119 consultas	R$ 0,84
R$ 300/mês até 454 consultas	R$ 0,66
R$ 500/mês até 833 consultas	R$ 0,60
R$ 1.000/mês até 2.000 consultas	R$ 0,50
R$ 3.000/mês até 6.250 consultas	R$ 0,48
R$ 10.000/mês até 22.727 consultas	R$ 0,44
R$ 20.000/mês até 55.555 consultas	R$ 0,36

O valor é cobrado por consulta, 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.

Atualização processual

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

Partes do processo

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