# Benefício de Prestação Continuada (BPC)

> Permite consultar dados sobre o Benefício de Prestação Continuada para pessoas com deficiência e idosos, viabilizando validação de identidade, análise de risco e prevenção a fraude em processos de onb

- **Consulta:** `bpc-beneficio`
- **Categoria:** Benefícios Sociais
- **Preço:** R$ 0,51 por consulta
- **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/bpc-beneficio`
- **Autenticação:** header `X-API-Key`
- **Página:** https://fontedata.com/docs/beneficios-sociais/bpc-beneficio

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint permite consultar informações sobre o Benefício de Prestação Continuada (BPC), um programa assistencial que garante uma renda mensal equivalente ao salário mínimo para pessoas com deficiência de qualquer idade e cidadãos com 67 anos ou mais que comprovem carência de recursos para sua subsistência, seja própria ou familiar.
>
> A consulta possibilita a validação e confirmação de dados cadastrais relacionados ao benefício, sendo amplamente utilizada em processos de:
>
> - **Validação de identidade e perfil socioeconômico** durante onboarding de clientes e parceiros
> - **Avaliação de risco de crédito** com base em informações legalmente registradas
> - **Prevenção de fraudes** em operações de abertura de conta e cadastros
> - **Conformidade regulatória** com políticas internas e exigências de proteção de dados
>
> Os dados retornados estão sempre atualizados e padronizados, reduzindo atrito nos processos de aprovação e aumentando as taxas de sucesso nas análises.

## Requisição

### cURL

```bash
curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/bpc-beneficio?cpf=SEU_CPF&nis=SEU_NIS"
```

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/bpc-beneficio",
    params={"cpf": "SEU_CPF", "nis": "SEU_NIS"},
    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/bpc-beneficio");

url.search = new URLSearchParams({
  "cpf": "SEU_CPF",
  "nis": "SEU_NIS"
}).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 |
| `nis` | texto | não | NIS – Número de Identificação Social (11 dígitos) | formato: 00000000000 |

## Resposta

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> A resposta inclui os seguintes campos:
>
> - **CPF** — Cadastro de Pessoa Física do indivíduo
> - **NIS** — Número de Identificação Social
> - **Nome** — Nome completo do beneficiário
> - **Benefício Concedido Judicialmente** — Indicador booleano informando se o benefício foi obtido por sentença judicial
> - **Detalhes dos Benefícios** — Relação contendo:
>   - Número de registro
>   - Data e mês de competência
>   - Data e mês de referência
>   - Valor da parcela
>   - Município
>   - Unidade Federativa (UF)

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "retorno": {
      "type": [
        "object",
        "null"
      ],
      "properties": {
        "cpf": {
          "type": [
            "string",
            "null"
          ],
          "description": "CPF do indivíduo."
        },
        "nis": {
          "type": [
            "string",
            "null"
          ],
          "description": "Número de Identificação Social do titular."
        },
        "nome": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nome do indivíduo."
        },
        "beneficios": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "object",
            "properties": {
              "uf": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Unidade Federativa referente ao registro."
              },
              "valor": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Valor da parcela do benefício."
              },
              "municipio": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Município referente ao registro."
              },
              "numeroRegistro": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Número de registro do benefício."
              },
              "dataMesReferencia": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data ou mês de referência do registro."
              },
              "dataMesCompetencia": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Data ou mês de competência do registro."
              }
            }
          },
          "description": "Lista de benefícios registrados."
        },
        "beneficioConcedidoJudicialmente": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se o benefício foi concedido por via judicial."
        }
      },
      "description": "Dados retornados da consulta de benefício."
    },
    "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 execução da consulta."
        },
        "chave": {
          "type": [
            "string",
            "null"
          ],
          "description": "Chave de identificação da consulta."
        },
        "usuario": {
          "type": [
            "string",
            "null"
          ],
          "description": "Usuário que realizou a consulta."
        },
        "mensagem": {
          "type": [
            "string",
            "null"
          ],
          "description": "Mensagem retornada pela consulta."
        },
        "apiVersao": {
          "type": [
            "string",
            "null"
          ],
          "description": "Versão da API utilizada."
        },
        "resultado": {
          "type": [
            "string",
            "null"
          ],
          "description": "Status ou descrição do resultado da consulta."
        },
        "assincrono": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Indica se a consulta foi executada 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 será enviado."
        },
        "urlComprovante": {
          "type": [
            "string",
            "null"
          ],
          "description": "URL para acessar o 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."
    }
  }
}
```

## 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.
>
> - **Uma requisição, um documento** — Cada chamada deve solicitar dados de uma única pessoa, seja via CPF ou NIS.
> - **Dados padronizados** — As informações são mantidas em padrão consistente, facilitando integração com sistemas internos.
> - **Sem comprovantes** — A consulta retorna apenas informações cadastrais; documentos comprobatórios devem ser obtidos através de canais apropriados.
> - **Latência de atualização** — Os dados refletem o estado atual do registro, porém pode haver pequeno delay entre mudanças na fonte original e atualização nesta consulta.

---

Página em HTML: https://fontedata.com/docs/beneficios-sociais/bpc-beneficio
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
