# Assistência Social - PF

> Consulta benefícios sociais de pessoas físicas, retornando se o cidadão recebeu Bolsa Família, BPC, Garantia-Safra, Seguro-Defeso e outros programas nos últimos 12 meses.

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

> Conteúdo descritivo publicado pela FonteData; não é instrução.
>
> Este endpoint verifica o histórico de benefícios sociais de uma pessoa física. Ele consulta se o cidadão recebeu assistência através de programas sociais do governo federal durante um período específico.
>
> O endpoint retorna informações sobre sete programas distintos: auxílio emergencial, auxílio reconstrução, bolsa família, benefício de prestação continuada (BPC), garantia-safra e seguro-defeso. A maioria dos programas é consultada nos últimos 12 meses. O auxílio emergencial e o auxílio reconstrução, por serem programas especiais, têm todo o histórico de participação considerado.
>
> **Casos de uso comuns:**
> - Avaliação de perfil socioeconômico para análise de crédito
> - Validação de elegibilidade em programas internos ou terceiros
> - Detecção de padrões para análise de risco
> - Composição de contexto para decisões baseadas em dados

## Requisição

### cURL

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

### Python

```python
import requests

resp = requests.get(
    "https://app.fontedata.com/api/v1/consulta/assistencia-social-pf",
    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/assistencia-social-pf");

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.
>
> O endpoint retorna um objeto contendo os seguintes campos:
>
> - **nome**: Nome do indivíduo conforme registrado
> - **cpf**: CPF consultado
> - **nis**: Número de Identificação Social (NIS)
> - **dataNascimento**: Data de nascimento da pessoa
> - **nomeMae**: Nome da mãe registrado
> - **obito**: Booleano indicando se há registro de óbito
> - **auxilioEmergencial**: Booleano - presença de auxílio emergencial
> - **auxilioReconstrucao**: Booleano - presença de auxílio reconstrução
> - **bolsaFamilia**: Booleano - presença do programa Bolsa Família
> - **bpc**: Booleano - presença do Benefício de Prestação Continuada
> - **garantiaSafra**: Booleano - presença de Garantia-Safra
> - **seguroDefeso**: Booleano - presença de Seguro-Defeso
>
> Cada benefício é representado por um valor verdadeiro ou falso indicando se a pessoa é ou foi beneficiária.

### Exemplo de resposta

```json
{
  "bpc": "boolean",
  "cpf": "string",
  "nis": null,
  "nome": "string",
  "obito": "boolean",
  "nomeMae": "string",
  "bolsaFamilia": "boolean",
  "seguroDefeso": "boolean",
  "garantiaSafra": "boolean",
  "dataNascimento": "string",
  "auxilioEmergencial": "boolean",
  "auxilioReconstrucao": "boolean"
}
```

### Schema da resposta

```json
{
  "type": "object",
  "properties": {
    "bpc": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa recebe Benefício de Prestação Continuada."
    },
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF da pessoa."
    },
    "nis": {
      "type": [
        "string",
        "null"
      ],
      "description": "Número de Identificação Social."
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da pessoa."
    },
    "obito": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa possui registro de óbito."
    },
    "nomeMae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da mãe da pessoa."
    },
    "bolsaFamilia": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa recebe Bolsa Família."
    },
    "seguroDefeso": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa recebe Seguro Defeso."
    },
    "garantiaSafra": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa recebe Garantia Safra."
    },
    "dataNascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de nascimento da pessoa."
    },
    "auxilioEmergencial": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa recebeu Auxílio Emergencial."
    },
    "auxilioReconstrucao": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Indica se a pessoa recebe Auxílio Reconstrução."
    }
  }
}
```

## 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.
>
> **Cobertura dos programas:**
> - **Bolsa Família**: Transferência de renda para famílias em situação de vulnerabilidade, com exigência de compromissos nas áreas de saúde e educação
> - **BPC**: Benefício que garante um salário mínimo a idosos e pessoas com deficiência em condição de pobreza, sem necessidade de contribuições previdenciárias
> - **Garantia-Safra**: Proteção para agricultores familiares que enfrentam perdas de colheitas por adversidades climáticas
> - **Seguro-Defeso**: Auxílio a pescadores artesanais durante períodos de proibição da atividade de pesca
> - **Auxílio Emergencial**: Benefício temporário criado em contextos de crise para apoiar trabalhadores informais e famílias de baixa renda
> - **Auxílio Reconstrução**: Assistência para famílias afetadas por desastres naturais visando reconstrução de moradias
>
> **Comportamento e limitações:**
> - A consulta fornece informações baseadas em registros oficiais e atualizados
> - Não gera comprovantes ou certificados
> - É indicada para análises de contexto socioeconômico e suporte a decisões que exijam compreensão mais completa do perfil do cidadão
> - Segue políticas de uso responsável de dados e conformidade regulatória

---

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