Listar processos de um cliente

GET

/queries/clients/{clientId}/lawsuits

Lista, com paginação, os processos judiciais encontrados na consulta de processos mais recente do cliente, junto com os totalizadores da consulta (total de processos, por polo, por situação e por natureza). Os totalizadores se referem à consulta inteira e não mudam com os filtros. A página tem 60 processos por padrão (perPage) e nextPage indica se há mais páginas. Os filtros pole, status, homonyms, states e tags podem ser combinados; status, states e tags recebem uma lista em JSON, por exemplo ["ATIVO","ARQUIVADO"], e os valores disponíveis para o cliente são os devolvidos por Listar filtros de processos de um cliente. numFilter busca pelo número do processo, com ou sem pontuação. Cada processo vem sem as fontes, os andamentos e as decisões; para ver os andamentos, use Visualizar processo de um cliente. Quando o cliente ainda não tem consulta de processos, a resposta é 200 apenas com nextPage igual a false. Filtro com formato inválido devolve 422. 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

Processos do cliente

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

🟠422Filtro inválido

Request Example

Shell

JavaScript

Java

Swift

curl --location '/queries/clients//lawsuits?page=&sort=&numFilter=&perPage=&pole=&status=&homonyms=&states=&tags=' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "_id": "d4e5f6a7-0000-4000-8000-0000000000c1",
    "queryId": "a1b2c3d4-0000-4000-8000-0000000000q1",
    "taxId": "11222333000181",
    "clientId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "clientName": "FAZENDA EXEMPLO LTDA",
    "total": 3,
    "author": 1,
    "defendant": 2,
    "active": 2,
    "inactive": 1,
    "indefinite": 0,
    "civil": 2,
    "labour": 1,
    "criminal": 0,
    "tributary": 0,
    "executions": 1,
    "items": [
        {
            "_id": "b1f4c2d0-0000-4000-8000-00000000a001",
            "LawsuitId": "d4e5f6a7-0000-4000-8000-0000000000c1",
            "Number": "12345678920238260100",
            "Type": "EXECUÇÃO DE TÍTULO EXTRAJUDICIAL",
            "MainSubject": "CÉDULA DE CRÉDITO RURAL",
            "CourtName": "TJSP",
            "CourtLevel": "1",
            "CourtType": "ESTADUAL",
            "JudgingBody": "1ª VARA CÍVEL",
            "State": "SP",
            "Status": "ATIVO",
            "Value": 250000.5,
            "PublicationDate": "2023-03-10T00:00:00",
            "LastMovementDate": "2026-08-20T00:00:00",
            "Parties": [
                {
                    "Name": "BANCO EXEMPLO S.A.",
                    "Doc": "33444555000100",
                    "Polarity": "ATIVO"
                },
                {
                    "Name": "FAZENDA EXEMPLO LTDA",
                    "Doc": "11222333000181",
                    "Polarity": "PASSIVO"
                }
            ],
            "Tags": [
                {
                    "tag": "Cível"
                }
            ],
            "Homonym": false,
            "Polarity": "Passivo",
            "createdAt": "2026-06-17T14:17:24.677Z",
            "updatedAt": "2026-06-17T14:17:24.677Z"
        }
    ],
    "todos": 3,
    "ativo": 1,
    "passivo": 2,
    "outros": 0,
    "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

Consultar status de atualização de um processo

Próxima página

Exportar processos de um cliente (Excel)