Auxílio Emergencial

Name: FonteData
Author: FonteData

GET https://app.fontedata.com/api/v1/consulta/auxilio-emergencial

R$ 0,51 por consulta

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

Permite consultar dados de beneficiários do programa de auxílio emergencial. O endpoint retorna informações cadastrais e histórico de parcelas de beneficiários registrados, viabilizando análises de histórico de benefícios, validação de dados e integração com processos de avaliação de risco e crédito.

Use este endpoint para:

Validação de dados: Padronizar e confirmar informações cadastrais de indivíduos
Automação de consultas: Recuperar dados de benefícios para alimentar decisões operacionais
Processos de compliance e risco: Integrar dados históricos em fluxos de análise de crédito e avaliação de perfil de cliente

Requisição

curl -H "X-API-Key: SUA_CHAVE" \
  "https://app.fontedata.com/api/v1/consulta/auxilio-emergencial?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

A resposta contém os seguintes campos:

cpf: Número de CPF do indivíduo
nis: Código NIS (Número de Identificação Social) do titular
nome: Nome completo do indivíduo registrado
beneficios: Array contendo o histórico de parcelas, onde cada item inclui:
- numeroRegistro — Identificador único do registro
- data — Data em que o benefício foi registrado
- situacao — Status atual da parcela (exemplo: pago, pendente)
- enquadramento — Classificação do beneficiário conforme critérios do programa
- valor — Quantia da parcela
- numeroParcela — Sequência da parcela dentro do benefício
- municipio — Município de referência do registro
- uf — Unidade Federativa (estado)

Exemplo — 200 OK

{
  "cpf": "***",
  "nis": "0.000.000.000-0",
  "nome": "***",
  "beneficios": [
    {
      "uf": "RS",
      "data": "01/05/2020 00:00:00",
      "valor": "600,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 1,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/07/2020 00:00:00",
      "valor": "600,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 2,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/08/2020 00:00:00",
      "valor": "600,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 3,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/09/2020 00:00:00",
      "valor": "600,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 4,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/10/2020 00:00:00",
      "valor": "600,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 5,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/11/2020 00:00:00",
      "valor": "300,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 6,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/11/2020 00:00:00",
      "valor": "300,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 7,
      "numeroRegistro": null
    },
    {
      "uf": "RS",
      "data": "01/12/2020 00:00:00",
      "valor": "300,00",
      "situacao": "Não há",
      "municipio": "IJUI",
      "enquadramento": "EXTRACAD",
      "numeroParcela": 8,
      "numeroRegistro": null
    }
  ]
}

Schema da resposta (JSON Schema)

JSON Schema

{
  "type": "object",
  "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."
          },
          "data": {
            "type": [
              "string",
              "null"
            ],
            "description": "Data do registro no formato DD/MM/YYYY HH:mm:ss."
          },
          "valor": {
            "type": [
              "string",
              "null"
            ],
            "description": "Valor da parcela."
          },
          "situacao": {
            "type": [
              "string",
              "null"
            ],
            "description": "Situação do registro."
          },
          "municipio": {
            "type": [
              "string",
              "null"
            ],
            "description": "Município referente ao registro."
          },
          "enquadramento": {
            "type": [
              "string",
              "null"
            ],
            "description": "Enquadramento do registro."
          },
          "numeroParcela": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Número referente à parcela."
          },
          "numeroRegistro": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Número de registro."
          }
        }
      },
      "description": "Lista de beneficiários e pagamentos realizados."
    }
  }
}

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

Uma requisição por documento: Submeta apenas um CPF por chamada à API
Sem geração de comprovantes: Esta consulta retorna dados informativos e não gera documentos de comprovação
Atualização de dados: As informações refletem o estado histórico das parcelas do programa
Suporte: Em caso de dúvidas ou problemas na integração, entre em contato com nosso time de suporte

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.