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/v1/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/v1/consultas/buscador-processual

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

cURL

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/v1/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"
}
'

202

Example

{
  "statusCode": 202,
  "message": "Consulta assíncrona aceita",
  "timestamp": "2026-09-08T18:00:00.000Z",
  "path": "/api/v1/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/v1/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/v1/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

202

application/json

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

The response is of type object.