/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
- O
TOKEN
deve ser incluído como parâmetro obrigatório. - 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
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
CPF | string | Sim | CPF da pessoa a ser consultada (com ou sem formatação). |
TOKEN | string | Sim | Token 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ódigo | Descrição |
---|---|
200 | Sucesso: os dados da consulta foram retornados corretamente. |
400 | Requisição inválida: parâmetros incorretos. |
401 | Não autenticado: token inválido ou ausente. |
404 | Não encontrado: registro não localizado. |
500 | Erro 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.