Visualizar processo de um cliente

GET

/queries/clients/{clientId}/lawsuits/{_id}

Devolve os dados de um processo judicial do cliente, com número, classe, assunto, tribunal, UF, situação, valor, partes, petições, decisões, naturezas e o último resumo por IA, além de uma página de até 60 andamentos, do mais recente para o mais antigo. Informe em _id o identificador do processo devolvido em Listar processos de um cliente. Envie sempre page, começando por 1: na primeira visualização do processo no dia, os andamentos são buscados na fonte e só a página 1 é aceita; páginas ainda não carregadas devolvem 422. NextPage indica se há mais andamentos já carregados. Ao visualizar o processo, a plataforma pode solicitar automaticamente a atualização dos dados dele, no máximo uma vez por dia; quando isso acontece, QueryId traz o identificador da solicitação, e o andamento pode ser acompanhado em Consultar status de atualização de um processo. Processo inexistente ou de outro cliente devolve 200 apenas com NextPage igual a false. Processo sem número, quando a atualização automática se aplica, devolve 400. Só retorna dados de clientes vinculados à empresa do usuário autenticado: cliente inexistente devolve 404, e cliente de outra empresa devolve 401. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Caminho

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Dados do processo

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠400Processo sem número

🟠422Página de andamentos indisponível

🔴500Erro interno

Request Example

Shell

JavaScript

Java

Swift

curl --location '/queries/clients/7c9e6679-7425-40de-944b-e07fc1f90ae7/lawsuits/b1f4c2d0-0000-4000-8000-00000000a001?page=' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "_id": "b1f4c2d0-0000-4000-8000-00000000a001",
    "LawsuitId": "d4e5f6a7-0000-4000-8000-0000000000c1",
    "NumberOfVolumes": 1,
    "NumberOfPages": 120,
    "Value": 250000.5,
    "JusticeSecret": false,
    "PublicationDate": "2023-03-10T00:00:00",
    "LastMovementDate": "2026-08-20T00:00:00",
    "LastUpdate": "2026-08-21T00:00:00",
    "NumberOfParties": 2,
    "NumberOfUpdates": 34,
    "LawsuitAge": 1270,
    "AverageNumberOfUpdatesPerMonth": 0.8,
    "Number": "12345678920238260100",
    "Type": "EXECUÇÃO DE TÍTULO EXTRAJUDICIAL",
    "MainSubject": "CÉDULA DE CRÉDITO RURAL",
    "OtherSubjects": [],
    "CourtName": "TJSP",
    "CourtLevel": "1",
    "CourtType": "ESTADUAL",
    "CourtDistrict": "SÃO PAULO",
    "JudgingBody": "1ª VARA CÍVEL",
    "State": "SP",
    "Status": "ATIVO",
    "Parties": [
        {
            "Name": "BANCO EXEMPLO S.A.",
            "Doc": "33444555000100",
            "Polarity": "ATIVO"
        },
        {
            "Name": "FAZENDA EXEMPLO LTDA",
            "Doc": "11222333000181",
            "Polarity": "PASSIVO"
        }
    ],
    "Updates": [
        {
            "_id": "c7d8e9f0-0000-4000-8000-00000000u001",
            "DetailId": "b1f4c2d0-0000-4000-8000-00000000a001",
            "Content": "Juntada de petição.",
            "PublishDate": "2026-08-20",
            "CaptureDate": "2026-08-21T10:00:00.000Z",
            "IdFromPrimarySource": 987654,
            "Type": "PUBLICACAO",
            "TypePublication": "Intimação",
            "PredictedRank": {
                "Name": "Juntada",
                "Description": "Juntada de documento",
                "Hierarchy": "Movimentação > Juntada"
            },
            "Source": {
                "IdSource": 1,
                "Name": "Diário de Justiça Exemplo",
                "Type": "DIARIO",
                "Acronym": "DJEX",
                "Level": 1,
                "LevelFormatted": "1º grau",
                "Journal": "Caderno 1"
            }
        }
    ],
    "Petitions": [],
    "Decisions": [],
    "Tags": [
        {
            "tag": "Cível"
        }
    ],
    "Polarity": "PASSIVO",
    "NextPage": false,
    "createdAt": "2026-06-17T14:17:24.677Z",
    "updatedAt": "2026-06-17T14:17:24.677Z"
}

Modificado em 2026-10-13 09:47:06

Página anterior

Solicitar análise de processo judicial por IA

Próxima página

Consultar dados de cliente na Nutrien