> ## Documentation Index > Fetch the complete documentation index at: https://docs.jusfy.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Lista os processos de uma consulta concluída (paginado) > ⚠️ **Quando `truncated` é `true`, os processos são uma amostra arbitrária.** Guardamos no máximo 1.000 por consulta, e a ordem em que o provedor os entrega **não é cronológica** — então os processos devolvidos não são "os mais recentes", são 1.000 quaisquer entre os `totalFound` identificados. Dois totais, e confundi-los é o erro mais comum de integração: - **`total`** — processos armazenados: é o que você consegue paginar; - **`totalFound`** — o que a fonte alegou ter identificado. É um **limite inferior**: a fonte satura em 10.000, então esse valor significa "pelo menos 10.000". Consultar é **gratuito** — a cobrança aconteceu no disparo. Protocolo ainda em andamento, encerrado sem resultado ou já expurgado respondem `200` com `items: []`; `status` e `retained` dizem o porquê. O resultado fica disponível por 30 dias. ## OpenAPI ````yaml /openapi/legado.json get /api/consultas/buscador-processual/{id}/processos openapi: 3.0.0 info: title: Calculadoras Jusfy API description: >- Rotas sem versão (`/api/...`). Continuam funcionando, mas a versão atual da API é a v1 (`/api/v1`): para integrações novas, use a v1 e siga o [guia de migração](https://api.jusfy.dev/calculators/api/reference/fundamentos/migracao-do-legado). A política de versionamento e depreciação está na [política de versionamento](https://api.jusfy.dev/calculators/api/reference/fundamentos/migracao-do-legado#pol%C3%ADtica-de-versionamento). version: legacy contact: {} servers: - url: https://api.jusfy.dev/calculators security: [] tags: - name: Calculadoras description: >- Execução das calculadoras jurídicas e consulta dos índices de correção. Cada cálculo recebe um payload, retorna o resultado processado e exige API key no header `x-api-key`. - name: Consultas description: >- Consultas de dados (veículos, condutores e documentos). Cada consulta recebe o documento, retorna os dados encontrados e exige API key no header `x-api-key`. A maioria responde na mesma requisição; o **rastreamento veicular** e o **buscador processual** são assíncronos — devolvem `202` com um protocolo e entregam o resultado por webhook e/ou pelo `GET` do protocolo. - name: JusScore description: >- Consulta de processos judiciais por CPF/CNPJ, com score de risco consolidado e a lista detalhada dos processos. É assíncrona: o POST inicia a consulta e o GET devolve o resultado quando pronto. Exige API key no header `x-api-key`. - name: Consumo description: >- Consumo da própria API key: quantas chamadas cada produto recebeu num período, separando as cobradas das não cobradas. Não exige escopo; exige API key no header `x-api-key`. - name: Health description: >- Verificações de disponibilidade do serviço (liveness e readiness). Rotas abertas, sem autenticação. paths: /api/consultas/buscador-processual/{id}/processos: get: tags: - Consultas summary: Lista os processos de uma consulta concluída (paginado) description: >- ⚠️ **Quando `truncated` é `true`, os processos são uma amostra arbitrária.** Guardamos no máximo 1.000 por consulta, e a ordem em que o provedor os entrega **não é cronológica** — então os processos devolvidos não são "os mais recentes", são 1.000 quaisquer entre os `totalFound` identificados. Dois totais, e confundi-los é o erro mais comum de integração: - **`total`** — processos armazenados: é o que você consegue paginar; - **`totalFound`** — o que a fonte alegou ter identificado. É um **limite inferior**: a fonte satura em 10.000, então esse valor significa "pelo menos 10.000". Consultar é **gratuito** — a cobrança aconteceu no disparo. Protocolo ainda em andamento, encerrado sem resultado ou já expurgado respondem `200` com `items: []`; `status` e `retained` dizem o porquê. O resultado fica disponível por 30 dias. operationId: AsyncQueriesController_buscadorProcessualProcessos[0] parameters: - name: id required: true in: path description: O `id` devolvido no `202` do disparo. schema: example: aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607 type: string - name: page required: false in: query description: Página, começando em 1. schema: default: '1' example: '1' type: string - name: pageSize required: false in: query description: Itens por página. Máximo 200. schema: default: '50' example: '50' type: string responses: '200': description: Uma página dos processos armazenados. content: application/json: schema: type: object example: statusCode: 200 message: Processos localizados timestamp: '2026-09-08T18:20:00.000Z' path: >- /api/consultas/buscador-processual/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607/processos result: id: aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607 consulta: buscador-processual status: done retained: true page: 1 pageSize: 50 total: 1000 totalPages: 20 totalFound: 10000 returned: 1000 truncated: true items: - cnj: 0000001-23.2024.8.26.0100 title: Procedimento Comum Cível value: 45000 court_acronym: TJSP courts: - name: Tribunal de Justiça de São Paulo code: TJSP last_update: '2026-08-14T00:00:00.000Z' instance: 1 parties: - name: FULANO DE TAL document: '52998224725' document_type: cpf person_type: FISICA side: Ativo lawyers: - name: BELTRANO ADVOGADO type: ADVOGADO document: '11122233396' client: FULANO DE TAL document_type: cpf subjects: - name: Indenização por Dano Moral code: '10433' status: Ativo phase: Conhecimento situation: null area: Cível justice: '8' justice_description: Justiça Estadual tags: criminal: false labor: false last_step: step_date: '2026-08-14T00:00:00.000Z' content: Conclusos para despacho classifications: - name: Procedimento Comum Cível code: '7' secrecy_level: 0 distribution_date: '2024-03-11T00:00:00.000Z' '400': description: Parâmetros de paginação inválidos. content: application/json: schema: example: statusCode: 400 code: invalid_request message: - page deve ser um número inteiro positivo requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-09-02T18:00:00.000Z' path: /api/consultas/buscador-processual/{id}/processos '401': description: >- API key ausente ou que não pertence a nenhum cliente (`code: invalid_api_key`). A `message` diz qual dos dois. content: application/json: examples: missing: summary: Key ausente value: statusCode: 401 message: Missing API key code: invalid_api_key requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/consultas/{consulta} invalid: summary: Key inválida value: statusCode: 401 message: Invalid API key code: invalid_api_key requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/consultas/{consulta} '403': description: >- Acesso negado. Dois motivos, distinguidos pelo `code`: o cliente não está ativo (`inactive_client`), ou a API key não tem o escopo deste produto (`insufficient_scope`, com o escopo na `message`). A liberação de produtos é feita pela equipe Jusfy. content: application/json: examples: inactive_client: summary: Cliente não ativo value: statusCode: 403 message: Client is not active code: inactive_client requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/consultas/{consulta} insufficient_scope: summary: Sem o escopo do produto value: statusCode: 403 message: 'Missing scope: ' code: insufficient_scope requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-10-14T18:00:00.000Z' path: /api/consultas/{consulta} '404': description: Protocolo inexistente — ou pertencente a outro cliente. content: application/json: schema: example: statusCode: 404 code: resource_not_found message: Query aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607 not found requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-09-02T18:00:00.000Z' path: /api/consultas/buscador-processual/{id}/processos '429': description: >- Limite de requisições por minuto do cliente neste produto excedido. `Retry-After` diz em quantos segundos a janela vira. Toda resposta traz `X-RateLimit-Limit`, `X-RateLimit-Remaining` e `X-RateLimit-Reset`. content: application/json: schema: example: statusCode: 429 code: rate_limit_exceeded message: >- Rate limit exceeded for consultas.rastreamento-veicular:execute: 60 requests per minute. Retry in 42s. requestId: 9f1c2b7e-4d3a-4f8b-a6e2-1c0d9e8f7a65 timestamp: '2026-06-22T18:00:00.000Z' path: /api/consultas/rastreamento-veicular security: - api-key: [] components: securitySchemes: api-key: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.