SCR — Sistema de Informação de Crédito

O SCR (Sistema de Informações de Crédito) é o registro oficial do Banco Central do Brasil de operações de crédito. Cada instituição financeira do país reporta a ele: empréstimos, financiamentos, limites, garantias e co-obrigacões acima de R$200. É a própria fonte, não uma pontuação inferida a partir dela.

Pluggy expõe o SCR por trás de um item conectado de Open Finance. O item fornece o CPF ou CNPJ e serve como evidência do consentimento do titular da conta.

Requisitos#

Antes da primeira chamada:

1. O recurso SCR habilitado em sua assinatura.
2. Um item conectado de Open Finance. Conectores diretos não são elegíveis.
3. O CPF ou CNPJ desse item conhecido por nós — é o que consultamos no Bacen.

Um item que falhar em qualquer um dos últimos dois retorna SCR_ITEM_NOT_SUPPORTED.

Consulte o SCR#

GET /items/{id}/scr

curl --request GET \
  --url 'https://api.pluggy.ai/items/d0e8448e-0156-4b4a-ae6c-3e2a6d9bff5c/scr?from=202604&to=202607' \
  --header 'X-API-KEY: YOUR_API_KEY'

Detalhes completos sobre parâmetros e esquema estão na referência da APIAPI.

Datas-base são meses, e elas têm atraso#

O SCR não funciona em dias. O Bacen consolida uma data-base (data-base) por mês, e cada uma só se torna completa alguns meses depois — as instituições ainda estão entregando seus relatórios nesse meio tempo.

Duas consequências que vale a pena considerar:

• Solicitar o mês atual não retorna nada. O Bacen ainda não o fechou.
• Quando você omite from e to, Pluggy consulta as últimas 4 datas-base, terminando 2 meses atrás a partir de hoje. Em setembro de 2026, isso é de 202604 a 202607.

Se você enviar apenas um limite, a janela se ancla nele: ?to=202501 retorna de 202410 a 202501.

Cada data-base carrega docProc e volProc — a porcentagem de documentos esperados e volume já incorporados. Uma data-base recente com baixa cobertura é uma imagem parcial, não uma vazia.

Resposta#

A resposta é o próprio payload do Bacen, encaminhado sem alterações. Nomes de campos, códigos e estrutura são do SCR, então um valor que você lê aqui é o mesmo valor que uma instituição lê na fonte.

{
  "dtbConsult": "202604 a 202607",
  "cdCli": "11222333",
  "tpCli": "2",
  "lsDtb": [
    {
      "dtb": 202607,
      "docProc": "99.8",
      "volProc": "99.9",
      "qtdIfs": 4,
      "qtdCongFinc": 3,
      "dtbIniRel": "201803",
      "coobAss": 0,
      "coobRec": 0,
      "lsOp": [
        {
          "mod": "0203",
          "oriRec": "0101",
          "indx": "01",
          "varCamb": "00",
          "resVenc": { "v20": 12500.0, "v40": 12500.0, "v110": 37500.0 },
          "lsGar": [{ "tp": "0501", "qtd": 1 }]
        }
      ]
    }
  ]
}

Nível superior#

Dentro de uma data-base (lsDtb[])#

Dentro de um grupo de operações (lsOp[])#

O SCR não retorna contratos um a um. As operações são agregadas pela combinação de modalidade, fonte de recursos, índice e variação cambial, então uma entrada pode representar vários contratos da mesma natureza.

Os códigos por trás de mod, oriRec, indx, varCamb e tp são do próprio Bacen. Seu significado é publicado na referência DOC3040 — leia lá em vez de inferi-los.

Vértices de maturidade (resVenc)#

resVenc distribui o saldo do grupo em 30 vértices, em BRL. Apenas os vértices que carregam um valor estão presentes. Eles se dividem em três famílias:

A janela exata por trás de cada código de vértice individual é definida pela referência DOC3040.

Erros#

Um 502 carrega um correlationId sob data. Cite-o ao relatar a falha para nós — é o que nos permite rastrear a consulta exata.

{
  "code": 502,
  "codeDescription": "SCR_SERVICE_UNAVAILABLE",
  "message": "O serviço SCR do Bacen está temporariamente indisponível. Por favor, tente novamente mais tarde.",
  "data": { "correlationId": "8047f6e9-bb9e-4b04-8515-e2210dc4c544" }
}