Hath DataHathData
API de consultaEm produção

Benefício social pelo CPF: programa e mês

Envie o CPF ou o NIS e receba do Portal da Transparência os benefícios federais pagos a essa pessoa: programa (BPC, Novo Bolsa Família, Pé-de-Meia, Seguro Defeso, Garantia Safra, Gás do Povo), mês de referência e município.

Checar benefícios em lote Ver todas as consultas

Acesso no mesmo dia, com crédito para testar · atualizado em 27 de outubro de 2026

  1. 1

    Entrada

    cpfnis
  2. 2

    Fonte oficial

    Portal da TransparênciaDetalhamento dos Benefícios ao Cidadão

  3. 3

    Saída

    JSON

  4. CobrançaSó consulta concluída

Você envia, você recebe

Formato da resposta. Beneficiário fictício.

Parâmetros

  • cpfopcional

    O CPF do beneficiário.

  • nisopcional

    O NIS, a chave dos programas sociais. Envie um dos dois.

Campos retornados

com_apontamentos
true quando a consulta encontrou algo que pede atenção (débito, processo, sanção).
certidao_emitida
Se o órgão emitiu o documento nesta consulta.
mensagem_orgao
A mensagem que o próprio portal devolveu, quando há.
documentos
Os documentos emitidos, um por item.
documentos[].com_apontamento
true quando este documento tem apontamento.
documentos[].dias_de_validade
Prazo de validade do documento, em dias.
documentos[].valida_ate
Data de validade, pronta para agendar a renovação.
documentos[].pdf_url
O documento emitido pelo órgão, guardado pela Hath.
documentos[].texto_completo
O texto integral do documento, extraído do PDF.
documentos[].total_registros
Quantos benefícios a consulta encontrou.
documentos[].beneficios
Um item por programa e mês.
documentos[].beneficios[].programa
O benefício pago.
documentos[].beneficios[].mes_referencia
O mês da parcela.
documentos[].beneficios[].municipio
Onde o benefício foi registrado.
documentos[].beneficios[].uf
UF do município.
documentos[].consultado_em
Data e hora da consulta.
Detalhamento dos Benefícios ao Cidadão no Portal da Transparência, com filtros e datas de atualização por programa

Cada programa tem a própria data de carga.

RespostaJSON
{"com_apontamentos": true,"certidao_emitida": false,"mensagem_orgao": "1 benefício encontrado.","documentos": [{"com_apontamento": true,"dias_de_validade": null,"valida_ate": null,"pdf_url": null,"texto_completo": "BPC, 09/2026, MUNICÍPIO EXEMPLO/UF","total_registros": 1,"beneficios": [{"programa": "BPC","mes_referencia": "2026-09","municipio": "MUNICÍPIO EXEMPLO","uf": "UF"}],"consultado_em": "2026-10-28T10:15:00"}]}

Como o resultado chega

A mesma estrutura em qualquer órgão: um status classificado e, quando a fonte emite, o PDF oficial. Só a consulta concluída é cobrada; tentativa sem resultado não entra na conta.

  • Regular

    verde

    Nada consta na fonte.

  • Atenção

    amarelo

    Há registro que não impede, como débito parcelado ou suspenso. Vale ler o documento.

  • Com apontamentos

    vermelho

    Consta débito, sanção ou processo. O documento vem junto.

  • Sem resposta

    cinza

    A fonte não respondeu, o captcha falhou ou ficou fora deste ciclo. Vira reprocessamento, nunca um "nada consta" falso.

A entrega sai em JSON, CSV, XLSX ou XML, por API REST, webhook ou direto no seu ERP. Portal que muda de layout, adiciona captcha ou troca de sistema é conta nossa: você paga pela entrega, não pelo conserto.

Como ler o resultado

A base junta programas com datas diferentes. Na captura, BPC, Seguro Defeso, Gás do Povo e Garantia Safra iam até setembro de 2026; o Novo Bolsa Família, até agosto; o Pé-de-Meia, até junho. Programas encerrados, como o Auxílio Emergencial e o Auxílio Brasil, seguem consultáveis no histórico.

Ausência na lista quer dizer que nada foi pago até a última carga daquele programa, não que a pessoa nunca vá receber.

Perguntas frequentes

Quais programas entram?

BPC, Novo Bolsa Família, Pé-de-Meia, Seguro Defeso, Garantia Safra, Gás do Povo, Auxílio Reconstrução e os históricos.

Precisa de login?

Não. É dado aberto do Portal da Transparência.

CPF ou NIS?

Qualquer um dos dois serve de chave.

API Benefícios ao Cidadão (Portal da Transparência) na sua integração

Em produção. Acesso no mesmo dia, com crédito para testar.

Checar benefícios em lote

A coleta é feita em fonte pública oficial: a Hath Data não é a fonte e não certifica o conteúdo publicado pelo órgão. O serviço é prestado sob contrato, o cliente é o controlador dos dados e declara a finalidade; a Hath atua como operadora. Nomes de órgãos são citados apenas para identificar a fonte, sem vínculo ou endosso. Veja os termos de uso e a política de privacidade.