Dispara a busca de processos de um CPF ou CNPJ (assíncrona)

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/consultas/buscador-processual \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "52998224725",
  "url_retorno": "https://cliente.exemplo.com/webhooks/jusfy"
}
'

import requests

url = "https://api.jusfy.dev/calculators/api/consultas/buscador-processual"

payload = {
    "document": "52998224725",
    "url_retorno": "https://cliente.exemplo.com/webhooks/jusfy"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    document: '52998224725',
    url_retorno: 'https://cliente.exemplo.com/webhooks/jusfy'
  })
};

fetch('https://api.jusfy.dev/calculators/api/consultas/buscador-processual', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'document' => '52998224725',
    'url_retorno' => 'https://cliente.exemplo.com/webhooks/jusfy'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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": 202,
  "message": "Consulta assíncrona aceita",
  "timestamp": "2026-09-08T18:00:00.000Z",
  "path": "/api/consultas/buscador-processual",
  "result": {
    "id": "aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607",
    "consulta": "buscador-processual",
    "status": "pending",
    "createdAt": "2026-09-08T18:00:00.000Z",
    "expiresAt": "2026-09-08T18:30:00.000Z",
    "statusUrl": "/api/consultas/buscador-processual/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607",
    "url_retorno": "https://cliente.exemplo.com/webhooks/jusfy",
    "signingSecret": "whsec_Jd3nP8xQ2vR7tY1uW4zA6bC9eF0gH5iK8lM3oN7qS2u"
  }
}

Consultas

Dispara a busca de processos de um CPF ou CNPJ (assíncrona)

Inicia a busca por processos judiciais associados ao documento. A consulta não responde na hora: o fornecedor processa por tempo indeterminado, então esta rota devolve 202 com um protocolo.

O resultado é obtido em duas partes: o resumo (quantos processos foram encontrados) chega por webhook e pelo GET do protocolo, e os processos vêm por GET /api/consultas/buscador-processual/{id}/processos, paginado. Eles não vêm no webhook porque um documento com muitos processos gera megabytes de payload.

Guardamos no máximo 1.000 processos por consulta. Acima disso a resposta traz truncated: true — e, nesse caso, os processos devolvidos são uma amostra arbitrária: a ordem em que o fornecedor os entrega não é cronológica, então eles não são “os mais recentes”.

A consulta é cobrada neste disparo, não na entrega — inclusive se o processamento depois expirar. Não há deduplicação: dois disparos para o mesmo documento são duas consultas cobráveis. Em caso de erro de rede sem resposta, prefira consultar antes de repetir — nesta consulta um erro não garante que nada foi cobrado.

POST

api

consultas

buscador-processual

Dispara a busca de processos de um CPF ou CNPJ (assíncrona)

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/consultas/buscador-processual \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "52998224725",
  "url_retorno": "https://cliente.exemplo.com/webhooks/jusfy"
}
'

import requests

url = "https://api.jusfy.dev/calculators/api/consultas/buscador-processual"

payload = {
    "document": "52998224725",
    "url_retorno": "https://cliente.exemplo.com/webhooks/jusfy"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    document: '52998224725',
    url_retorno: 'https://cliente.exemplo.com/webhooks/jusfy'
  })
};

fetch('https://api.jusfy.dev/calculators/api/consultas/buscador-processual', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'document' => '52998224725',
    'url_retorno' => 'https://cliente.exemplo.com/webhooks/jusfy'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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": 202,
  "message": "Consulta assíncrona aceita",
  "timestamp": "2026-09-08T18:00:00.000Z",
  "path": "/api/consultas/buscador-processual",
  "result": {
    "id": "aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607",
    "consulta": "buscador-processual",
    "status": "pending",
    "createdAt": "2026-09-08T18:00:00.000Z",
    "expiresAt": "2026-09-08T18:30:00.000Z",
    "statusUrl": "/api/consultas/buscador-processual/aqry_7c2e1a90-3b4d-5e6f-8a91-b2c3d4e5f607",
    "url_retorno": "https://cliente.exemplo.com/webhooks/jusfy",
    "signingSecret": "whsec_Jd3nP8xQ2vR7tY1uW4zA6bC9eF0gH5iK8lM3oN7qS2u"
  }
}

Autorizações

x-api-key

string

header

obrigatório

Corpo

application/json

document

string

obrigatório

CPF ou CNPJ do titular consultado, com ou sem máscara. Separadores (incluindo a barra do CNPJ) são aceitos e ignorados. O dígito verificador é validado antes da consulta.

Exemplo:

"52998224725"

url_retorno

string

URL https que receberá o aviso quando a consulta terminar. Opcional: sem ela, o resultado é obtido apenas pelas rotas de protocolo. O webhook leva os processos quando eles cabem no corpo (teto de 64 KiB, ~16 processos); acima disso leva só o resumo (totalFound, returned, truncated). O campo dataIncluded, no topo do corpo, diz qual dos dois casos ocorreu — e quando é false a chave lawsuits fica ausente, nunca vazia. Em qualquer caso os processos podem ser buscados em GET /api/consultas/buscador-processual/{id}/processos, paginado. Deve apontar para um domínio público na porta 443; endereços IP, hosts internos e http são recusados. A entrega é assinada; o segredo vem no campo signingSecret da resposta e não é exibido novamente.

Exemplo:

"https://cliente.exemplo.com/webhooks/jusfy"

Resposta

Consulta aceita e em processamento. Guarde o id — e o signingSecret, que não é exibido novamente.

The response is of type object.

Legado

Calculadoras

Consultas

JusScore

Health

Dispara a busca de processos de um CPF ou CNPJ (assíncrona)

Autorizações

Corpo

Resposta