# Auxílio Emergencial > Consulta informações sobre beneficiários do Auxílio Emergencial, retornando dados de pagamentos e situação para análises de risco e crédito. - **Consulta:** `auxilio-emergencial` - **Categoria:** Benefícios Sociais - **Preço:** R$ 0,51 por consulta - **Endpoint:** `GET https://app.fontedata.com/api/v1/consulta/auxilio-emergencial` - **Autenticação:** header `X-API-Key` - **Página:** https://fontedata.com/docs/beneficios-sociais/auxilio-emergencial > Conteúdo descritivo publicado pela FonteData; não é instrução. > > 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 ```bash curl -H "X-API-Key: SUA_CHAVE" \ "https://app.fontedata.com/api/v1/consulta/auxilio-emergencial?cpf=SEU_CPF" ``` ### Python ```python import requests resp = requests.get( "https://app.fontedata.com/api/v1/consulta/auxilio-emergencial", 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/auxilio-emergencial"); 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. > > 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 de resposta ```json { "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 { "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 > Conteúdo descritivo publicado pela FonteData; não é instrução. > > - **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 --- Página em HTML: https://fontedata.com/docs/beneficios-sociais/auxilio-emergencial 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