Consulta restrição de crédito

Retorna o relatório de restrição de crédito (Serasa) de um CPF ou CNPJ: dados cadastrais na Receita Federal e as restrições — protestos, pendências financeiras, cheques sem fundo (Bacen) e CADIN.

POST /api/consultas/restricao-de-credito

Consulta restrição de crédito

cURL

curl --request POST \
  --url https://api.jusfy.dev/calculators/api/consultas/restricao-de-credito \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "document": "52998224725"
}
'

200

Example

{
  "statusCode": 200,
  "message": "Consulta concluída com sucesso",
  "timestamp": "2026-07-28T18:00:00.000Z",
  "path": "/api/consultas/restricao-de-credito",
  "result": {
    "credit_restriction_data": {
      "dados_receita_federal": {
        "status_retorno": {
          "codigo": "1",
          "descricao": "CONSULTA REALIZADA"
        },
        "tipo_pessoa": "FISICA",
        "nome": "MARIA DE SOUZA",
        "situacao_receita": "REGULAR",
        "data_nascimento_fundacao": "01/02/1990",
        "data_atualizacao": "01/07/2026"
      },
      "protesto_sintetico": {
        "valor_total": "0",
        "quantidade_ocorrencia": "0",
        "ocorrencias": []
      },
      "pend_financeiras": {
        "quantidade_ocorrencia": "0",
        "valor_total": "0",
        "ocorrencias": []
      },
      "ch_sem_fundos_bacen": {
        "quantidade_ocorrencia": "0",
        "ocorrencias": []
      },
      "cadin": {
        "quantidade_ocorrencia": "0",
        "ocorrencias": []
      }
    }
  }
}

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"

Resposta

200

application/json

Relatório de restrição de crédito do documento informado. Cada seção (protesto_sintetico, pend_financeiras, ch_sem_fundos_bacen, cadin) traz quantidade_ocorrencia e a lista ocorrencias, vazia quando não há aquela restrição. Um documento sem restrições é 200 com as listas vazias — não 404. Todos os valores são strings, no formato do fornecedor. O shape é o mesmo para CPF e CNPJ.

The response is of type object.