# Banco Central - Inabilitados

> Consulta pessoas temporariamente inabilitadas para cargos em instituições financeiras, retornando penalidades e restrições. Essencial para compliance, análise de risco e decisões de crédito.

- **Consulta:** `bc-inabilitados`
- **Categoria:** Banco Central
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/bc-inabilitados`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/banco-central/bc-inabilitados

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Consulta registros de indivíduos que estão temporariamente impedidos de atuar em instituições financeiras ou consórcios, conforme determinações regulatórias. O recurso retorna informações sobre bloqueios administrativos, incluindo motivos, prazos e histórico de restrições aplicadas.
>
> Ideal para integração em processos de avaliação de risco, validação cadastral em fluxos de crédito e conformidade regulatória. Reduz a necessidade de consultas manuais repetitivas e aumenta a confiabilidade na detecção de impedimentos antes de operações críticas.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/bc-inabilitados?cpf=SEU_CPF"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/bc-inabilitados",
    params={"cpf": "SEU_CPF"},
    headers={"X-API-Key": "SUA_CHAVE"},
    timeout=60,
)
resp.raise_for_status()
print(resp.json())
```

### Node.js

```javascript
const url = new URL("https://app.fontedata.com/api/v1/consulta/bc-inabilitados");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF"
}).toString();

const resp = await fetch(url, {
  method: "GET",
  headers: { "X-API-Key": "SUA_CHAVE" }
});

if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
console.log(await resp.json());
```

## Parâmetros

| Nome | Tipo | Obrigatório | Descrição | Exemplo |
|---|---|---|---|---|
| `cpf` | CPF | sim | CPF (somente números, 11 dígitos) | formato: 000.000.000-00 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta contém dois níveis de informação:
>
> **Metadados gerais da consulta:**
> - `data` — Data e hora da execução
> - `message` — Descrição do resultado ou situação
>
> **Dados do indivíduo:**
> - `found` — Booleano indicando se há registros de impedimento
> - `nome` — Nome completo do indivíduo
> - `cpf` — CPF consultado
> - `observacoes` — Anotações complementares sobre o registro
> - `constamPenalidades` — Verdadeiro se existem restrições ativas
> - `penalidades` — Lista estruturada com:
>   - `numeroPAS` — Identificador do processo administrativo
>   - `descricao` — Motivo ou tipo de impedimento
>   - `dataInicio` — Quando a restrição começou
>   - `dataFim` — Data prevista para encerramento
>   - `prazoEmAnos` — Duração em anos da penalidade

### Exemplo de resposta

```json
{
  "consta": "boolean",
  "mensagem": "string",
  "parametros": {
    "cpf": "string"
  }
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "data": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "retorno": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "cpf": {
              "type": [
                "string",
                "null"
              ],
              "description": "CPF do indivíduo."
            },
            "nome": {
              "type": [
                "string",
                "null"
              ],
              "description": "Nome do indivíduo consultado."
            },
            "observacoes": {
              "type": [
                "string",
                "null"
              ],
              "description": "Observações adicionais sobre o registro."
            },
            "penalidades": {
              "type": [
                "array",
                "null"
              ],
              "items": {
                "type": "object",
                "properties": {
                  "dataFim": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Data de término da penalidade."
                  },
                  "descricao": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Descrição da penalidade aplicada."
                  },
                  "numeroPAS": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Número do Processo Administrativo Sancionador."
                  },
                  "dataInicio": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Data de início da penalidade."
                  },
                  "prazoEmAnos": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Duração da penalidade em anos."
                  }
                }
              },
              "description": "Lista de penalidades associadas ao indivíduo."
            },
            "constamPenalidades": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indica se o indivíduo possui penalidades."
            }
          },
          "description": "Dados retornados da consulta."
        },
        "metaDados": {
          "type": [
            "object",
            "null"
          ],
          "properties": {
            "ip": {
              "type": [
                "string",
                "null"
              ],
              "description": "Endereço IP de origem da requisição."
            },
            "data": {
              "type": [
                "string",
                "null"
              ],
              "description": "Data e hora de execução da consulta."
            },
            "chave": {
              "type": [
                "string",
                "null"
              ],
              "description": "Chave de autenticação utilizada."
            },
            "usuario": {
              "type": [
                "string",
                "null"
              ],
              "description": "Usuário que realizou a consulta."
            },
            "mensagem": {
              "type": [
                "string",
                "null"
              ],
              "description": "Mensagem descritiva da resposta."
            },
            "apiVersao": {
              "type": [
                "string",
                "null"
              ],
              "description": "Versão da API utilizada."
            },
            "resultado": {
              "type": [
                "string",
                "null"
              ],
              "description": "Status textual do resultado da consulta."
            },
            "assincrono": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indica se a consulta foi processada de forma assíncrona."
            },
            "consultaUid": {
              "type": [
                "string",
                "null"
              ],
              "description": "Identificador único da consulta."
            },
            "resultadoId": {
              "type": [
                "number",
                "null"
              ],
              "description": "Identificador numérico do resultado."
            },
            "consultaNome": {
              "type": [
                "string",
                "null"
              ],
              "description": "Nome da consulta realizada."
            },
            "enviarCallback": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indica se um callback deve ser enviado."
            },
            "urlComprovante": {
              "type": [
                "string",
                "null"
              ],
              "description": "URL de acesso ao comprovante gerado."
            },
            "tempoExecucaoMs": {
              "type": [
                "number",
                "null"
              ],
              "description": "Tempo de execução da consulta em milissegundos."
            },
            "gerarComprovante": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indica se um comprovante será gerado."
            }
          },
          "description": "Metadados da consulta."
        }
      },
      "description": "Dados da consulta ao quadro geral de inabilitados."
    },
    "found": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se o registro foi encontrado na consulta."
    },
    "message": {
      "type": [
        "string",
        "null"
      ],
      "description": "Mensagem descritiva da resposta."
    }
  }
}
```

## Códigos de erro

| Código | Mensagem | Quando acontece |
|---|---|---|
| `400` | Requisição Inválida | a requisição está incorreta ou os parâmetros são inválidos. |
| `401` | Não Autenticado | o usuário não forneceu as credenciais corretas para acessar o recurso. |
| `403` | Não Autorizado | o servidor recebeu a requisição, mas se negou a autorizá-la por conta de saldo indisponível. |
| `404` | Não Encontrado | o servidor não encontrou uma representação atual do recurso solicitado. |
| `408` | Tempo Esgotado | o servidor não conseguiu retornar a requisição no prazo estabelecido. |
| `500` | Falha ao Realizar Consulta | o servidor não conseguiu processar a requisição com sucesso. Por favor, entre em contato com o nosso suporte. |
| `503` | Consulta em Manutenção | a consulta requisitada está em manutenção. Por favor, entre em contato com o nosso suporte. |

## Observações

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> - A consulta processa o resultado de forma síncrona, com retorno imediato.
> - O endpoint não gera documentos comprobatórios. O resultado é uma consulta informacional para fins de validação interna.
> - Quando um CPF não retorna registros, o campo `found` indica falso, mas a requisição é processada com sucesso.
> - Recomenda-se cachear resultados por período adequado ao seu contexto operacional, considerando que atualizações de impedimentos ocorrem periodicamente.
> - Integre este endpoint em workflows de compliance para automatizar verificações e reduzir riscos em decisões operacionais.

---

Página em HTML: https://fontedata.com/docs/banco-central/bc-inabilitados
Catálogo completo: https://fontedata.com/docs
OpenAPI (JSON): https://app.fontedata.com/api/v1/openapi.json
Conectar via MCP: https://fontedata.com/docs/mcp