Assistência Social - PF

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/assistencia-social-pf

R$ 1,07 por consulta

Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.

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 -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/assistencia-social-pf?cpf=SEU_CPF"

Parâmetros

Nome	Tipo	Descrição	Exemplo
cpf obrigatório	CPF	CPF (somente números, 11 dígitos)	000.000.000-00

Resposta

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 — 200 OK

{
  "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 Schema)

JSON Schema

{
  "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

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

Integrar

OpenAPI (JSON) ↗ — importe a URL no Postman ou no Insomnia para gerar a coleção com todos os endpoints. Também dá para consultar pelo chat: conecte via MCP. Esta página em Markdown.