Voltar para Finance 360 API

Score

SCORE

Score de crédito K3 do CPF (escala 0–1000) calculado a partir de dados Open Finance.

Endpoint

POST /api/client/provider/open-finance

Método

POST

Autenticação

Bearer JWT

Descrição

Retorna o score de crédito K3 do CPF (escala 0–1000), calculado a partir de dados Open Finance. Quanto maior, melhor o perfil de crédito.

Request Body

Content-Type: application/json
Campo Tipo Obrigatorio Descricao
document string Sim CPF do consultado (11 dígitos, somente números).
product_code array Sim Lista de códigos de produto a consultar. Pode combinar vários relatórios Open Finance numa única requisição.

Exemplo

{
    "document": "12345678901",
    "product_code": [
        "SCORE"
    ]
}

Exemplo cURL

curl -X POST \
  https://positivaconnect.positivaconsultas.com.br/api/client/provider/open-finance \
  -H "Authorization: Bearer {seu_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "document": "12345678901",
    "product_code": ["SCORE"]
  }'

Formato do Envelope de Resposta

200 OK 
{
  "success": true,
  "document": "12345678901",
  "provider": "open-finance",
  "query_date": "2026-03-18T10:00:00",
  "results": {
    "SCORE": {
      "success": true,
      "data": { ... }
    }
  }
}

Quando results.SCORE.success for false, indica falha de comunicação com o provider externo (timeout, erro 5xx). Erros de autorização são rejeitados antes da consulta com HTTP 403.

Campos do data

Campo Descrição
reportStatus Código HTTP do status do relatório na Klavi (200 = sucesso).
requestId Identificador único da requisição na Klavi.
productName Código do produto consultado na Klavi (ex.: pf_klavi_income_eco).
productVersion Versão do produto (ex.: V1).
productReportTime Data e hora de geração do relatório (ISO 8601).
enquiryCpf CPF consultado.
score Score de crédito K3, número inteiro na escala 0–1000.

Exemplo de Resposta

Conteúdo de results.SCORE.data

200 OK 
{
    "reportStatus": 200,
    "requestId": "3510682ef8f84054ab088c1fdb9f8351",
    "productName": "pf_klavi_score_k3_eco",
    "productVersion": "V1",
    "productReportTime": "2026-08-19T17:49:25.187Z",
    "enquiryCpf": "76109277673",
    "score": 783
}

Respostas de Erro

400

invalid_request

Documento inválido, product_code ausente ou vazio

401

unauthenticated

Token JWT ausente ou inválido

403

product_not_authorized

Um ou mais produtos informados não estão contratados. A requisição inteira é rejeitada.

404

product_not_found

Um dos códigos em product_code não existe ou está inativo