Permite consultar o registro de profissionais e empresas temporariamente proibidos de prestar serviços de auditoria para instituições autorizadas pelo Banco Central. Útil para validação cadastral, automação de verificações em fluxos operacionais e integração com processos de análise de risco, crédito e conformidade.
curl -H "X-API-Key: SUA_CHAVE" \
"https://app.fontedata.com/api/v1/consulta/bc-proibidos?cpf=SEU_CPF"| Nome | Tipo | Descrição | Exemplo |
|---|---|---|---|
| cpf condicional | CPF | CPF (somente números, 11 dígitos) | 000.000.000-00 |
| cnpj condicional | CNPJ | CNPJ (somente números, 14 dígitos) | 00.000.000/0000-00 |
A resposta é estruturada nos seguintes campos:
data — Marca temporal da consulta no formato dd/MM/yyyy HH:mm:ss.
found — Indicador booleano que sinaliza se o indivíduo possui penalidades ativas no quadro geral de proibidos. Retorna true quando há restrições ou false quando não há.
message — Campo descritivo que contém informações sobre a penalidade encontrada. Quando aplicável, inclui detalhes como:
Quando nenhuma penalidade é encontrada, o campo retorna mensagem indicando a situação.
{
"data": null,
"found": false,
"message": "Nenhum registro encontrado"
}{
"type": "object",
"properties": {
"retorno": {
"type": [
"object",
"null"
],
"properties": {
"documento": {
"type": [
"string",
"null"
],
"description": "CPF ou CNPJ da entidade consultada."
},
"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 fim da penalidade."
},
"descricao": {
"type": [
"string",
"null"
],
"description": "Descrição da penalidade."
},
"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": "Prazo em anos da penalidade."
}
}
},
"description": "Lista de penalidades do indivíduo."
},
"nomeEntidade": {
"type": [
"string",
"null"
],
"description": "Nome da entidade ou razão social consultada."
},
"constamPenalidades": {
"type": [
"boolean",
"null"
],
"description": "Indica se o indivíduo possui restrições."
}
},
"description": "Dados de retorno da consulta sobre proibidos."
},
"metaDados": {
"type": [
"object",
"null"
],
"properties": {
"ip": {
"type": [
"string",
"null"
],
"description": "Endereço IP da requisição."
},
"data": {
"type": [
"string",
"null"
],
"description": "Data e hora da consulta."
},
"chave": {
"type": [
"string",
"null"
],
"description": "Chave associada à consulta."
},
"usuario": {
"type": [
"string",
"null"
],
"description": "Usuário que realizou a consulta."
},
"mensagem": {
"type": [
"string",
"null"
],
"description": "Mensagem de status da consulta."
},
"apiVersao": {
"type": [
"string",
"null"
],
"description": "Versão da API utilizada."
},
"resultado": {
"type": [
"string",
"null"
],
"description": "Descrição do resultado da consulta."
},
"assincrono": {
"type": [
"boolean",
"null"
],
"description": "Indica se a consulta foi 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 deve enviar callback."
},
"urlComprovante": {
"type": [
"string",
"null"
],
"description": "URL do comprovante gerado."
},
"tempoExecucaoMs": {
"type": [
"number",
"null"
],
"description": "Tempo de execução em milissegundos."
},
"gerarComprovante": {
"type": [
"boolean",
"null"
],
"description": "Indica se deve gerar comprovante."
}
},
"description": "Metadados da consulta."
}
}
}| 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. |
12345678909 ou 123.456.789-09).