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.

GET /api/consultas/buscador-processual/{id}/processos

Lista os processos de uma consulta concluída (paginado)

cURL

curl --request GET \
  --url https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos \
  --header 'x-api-key: <api-key>'

200

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" } ] } }

Autorizações

x-api-key · string · header · obrigatório

Parâmetros de caminho

id · string · obrigatório

O id devolvido no 202 do disparo.

Exemplo:

"aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607"

Parâmetros de consulta

page · string · padrão: 1

Página, começando em 1.

Exemplo:

"1"

pageSize · string · padrão: 50

Itens por página. Máximo 200.

Exemplo:

"50"

Resposta

200

application/json

Uma página dos processos armazenados.

The response is of type object.