/api/BancoCentralInabilitados

💡 O endpoint /api/BancoCentralInabilitados permite consultar informações sobre o Quadro Geral de Inabilitados do Banco Central. Este recurso contém dados sobre indivíduos temporariamente impedidos de ocupar cargos em instituições financeiras ou consórcios devido a penalidades de inabilitação.


Introdução

A API Banco Central - Quadro Geral de Inabilitados oferece informações detalhadas sobre penalidades aplicadas, incluindo:

  • Dados do CPF e nome do penalizado;
  • Detalhes das penalidades, como prazo e descrição;
  • Datas de início e fim da inabilitação.

Essa API é ideal para análise de risco/crédito e compliance/ESG.


URL Base

https://apiv3.directd.com.br

Endpoint

GET /api/BancoCentralInabilitados

Autenticação

A autenticação é feita utilizando um TOKEN. Sem um token válido, o acesso será negado (401).

Regras de Autenticação

  1. O TOKEN deve ser incluído como parâmetro obrigatório.
  2. Caso o token seja inválido ou expirado, entre em contato pelo e-mail: suporte@directd.com.br.

Campos da API

  • Nome: Nome completo da pessoa penalizada.
  • CPF: CPF do penalizado.
  • Número PAS: Identificador da penalidade.
  • Descrição: Detalhes sobre a penalidade aplicada.
  • Prazo em Anos: Duração da inabilitação.
  • Data de Início: Data de início da penalidade.
  • Data de Fim: Data de término da penalidade.

Parâmetros

NomeTipoObrigatórioDescrição
CPFstringSimCPF da pessoa a ser consultada (com ou sem formatação).
TOKENstringSimToken necessário para autenticação.

Exemplo de Requisição

Usando cURL

curl -X 'GET' \
  'https://apiv3.directd.com.br/api/BancoCentralInabilitados?CPF=12345678945&TOKEN=68ADA2C3-8016-47DA-ADE6-13AE239308FE' \
  -H 'accept: application/json'

Respostas

Sucesso (200)

A consulta foi realizada com sucesso e retorna os dados da pessoa penalizada.

{
  "metaDados": {
    "consultaNome": "Banco Central - Quadro Geral de Inabilitados",
    "consultaUid": "direct-123456",
    "mensagem": "Consulta realizada com sucesso.",
    "resultado": "Sucesso",
    "apiVersao": "v3",
    "tempoExecucaoMs": 200
  },
  "retorno": {
    "nome": "João da Silva",
    "cpf": "12345678945",
    "penalidades": [
      {
        "numeroPAS": "123456",
        "descricao": "Inabilitação por fraude contábil.",
        "prazoEmAnos": "5",
        "dataInicio": "01/01/2020",
        "dataFim": "01/01/2025"
      }
    ]
  }
}

Códigos de Resposta

CódigoDescrição
200Sucesso: os dados da consulta foram retornados corretamente.
400Requisição inválida: parâmetros incorretos.
401Não autenticado: token inválido ou ausente.
404Não encontrado: registro não localizado.
500Erro interno: falha no processamento da requisição.

Notas Importantes

  • Apenas um CPF deve ser enviado por consulta.
  • Este endpoint não gera comprovantes.
  • Para dúvidas ou suporte, entre em contato pelo e-mail: suporte@directd.com.br.