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

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

import requests

url = "https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

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

Consultas

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

import requests

url = "https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jusfy.dev/calculators/api/consultas/buscador-processual/{id}/processos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "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

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

Uma página dos processos armazenados.

The response is of type object.

Legado

Calculadoras

Consultas

JusScore

Health

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

Autorizações

Parâmetros de caminho

Parâmetros de consulta

Resposta