Inicia uma consulta do JusScore

Recebe um CPF ou CNPJ e inicia a busca de processos judiciais. A consulta é assíncrona: a resposta normal traz situacao: "PROCESSANDO" e o id_consulta, que deve ser consultado em GET /api/v1/jus-score/{id_consulta} até concluir.

Quando o mesmo documento já foi consultado nos últimos 30 dias, o resultado completo vem já nesta resposta, com situacao: "CONCLUIDA".

Acompanhando a consulta (polling)

• Intervalo: repita o GET a cada ~15 segundos enquanto a situacao for "PROCESSANDO".
• Custo: a consulta é cobrada uma única vez, no POST. Os GETs de acompanhamento não são cobrados, em nenhuma situação.
• Estados: situacao só tem "PROCESSANDO" e "CONCLUIDA"; não existe estado de falha. Erros de comunicação com a base de processos voltam como 502/504 no GET e a consulta segue válida: repita em instantes.
• Quando desistir: tempo esperado de conclusão e limite de espera pendente: produto.
• Passado o limite: o que fazer (novo POST ou suporte) pendente: produto.

Webhook

Ainda não disponível na v1: enviar url_retorno responde 400. Acompanhe a consulta pelo GET acima.

POST /api/v1/jus-score

Inicia uma consulta do JusScore

cURL

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/v1/jus-score \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "documento": "14065221803",
  "url_retorno": "https://seu-sistema.com.br/webhooks/jus-score"
}
'

200

Autorizações

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

Corpo

application/json

documento · string · obrigatório

CPF (11 dígitos) ou CNPJ (14 dígitos) do consultado, com ou sem máscara. Separadores são aceitos e ignorados.

Exemplo:

"14065221803"

url_retorno · string

Ainda não disponível na v1: enviar este campo responde 400. Consulte o resultado pelo GET.

Exemplo:

"https://seu-sistema.com.br/webhooks/jus-score"

Resposta

200

application/json

Consulta iniciada (PROCESSANDO) ou resultado completo, quando o documento já estava em cache.