Consulta o protocolo de uma busca de processos

Devolve o estado da consulta e, quando concluída, o resumo do que foi encontrado. Os processos em si vêm por GET /api/v1/consultas/buscador-processual/{id}/processos.

Responde 200 nos quatro estados — inclusive quando a consulta falhou. Estados: pending, done (com data), error e expired (não concluiu dentro do prazo de expiresAt).

⚠️ Como o provedor não reporta falha, uma consulta que trava do lado dele permanece pending até expiresAt e só então vira expired — é indistinguível de “ainda processando”.

Consultar o protocolo é gratuito. O resultado fica disponível por 30 dias; depois disso a consulta segue done, mas data vem null.

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

Consulta o protocolo de uma busca de processos

cURL

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

200

Example

{
  "statusCode": 200,
  "message": "Consulta localizada",
  "timestamp": "2026-09-08T18:12:00.000Z",
  "path": "/api/v1/consultas/buscador-processual/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607",
  "result": {
    "id": "aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607",
    "consulta": "buscador-processual",
    "status": "done",
    "createdAt": "2026-09-08T18:00:00.000Z",
    "updatedAt": "2026-09-08T18:11:42.000Z",
    "expiresAt": "2026-09-08T18:30:00.000Z",
    "completedAt": "2026-09-08T18:11:42.000Z",
    "data": {
      "totalFound": 10000,
      "returned": 1000,
      "truncated": true
    }
  }
}

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"

Resposta

200

application/json

Estado atual da consulta. Em done, data traz o resumo: totalFound (identificados pela fonte — limite inferior, ela satura em 10.000), returned (guardados e pagináveis) e truncated.

The response is of type object.