Debitado do seu saldo a cada chamada cobrada. Autenticação pelo header X-API-Key. Veja como obter a chave.
Este endpoint permite consultar informações sobre o Benefício de Prestação Continuada (BPC), um programa assistencial que garante uma renda mensal equivalente ao salário mínimo para pessoas com deficiência de qualquer idade e cidadãos com 67 anos ou mais que comprovem carência de recursos para sua subsistência, seja própria ou familiar.
A consulta possibilita a validação e confirmação de dados cadastrais relacionados ao benefício, sendo amplamente utilizada em processos de:
Validação de identidade e perfil socioeconômico durante onboarding de clientes e parceiros
Avaliação de risco de crédito com base em informações legalmente registradas
Prevenção de fraudes em operações de abertura de conta e cadastros
Conformidade regulatória com políticas internas e exigências de proteção de dados
Os dados retornados estão sempre atualizados e padronizados, reduzindo atrito nos processos de aprovação e aumentando as taxas de sucesso nas análises.
Benefício Concedido Judicialmente — Indicador booleano informando se o benefício foi obtido por sentença judicial
Detalhes dos Benefícios — Relação contendo:
Número de registro
Data e mês de competência
Data e mês de referência
Valor da parcela
Município
Unidade Federativa (UF)
Schema da resposta (JSON Schema)
JSON Schema
{
"type": "object",
"properties": {
"retorno": {
"type": [
"object",
"null"
],
"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."
},
"valor": {
"type": [
"string",
"null"
],
"description": "Valor da parcela do benefício."
},
"municipio": {
"type": [
"string",
"null"
],
"description": "Município referente ao registro."
},
"numeroRegistro": {
"type": [
"number",
"null"
],
"description": "Número de registro do benefício."
},
"dataMesReferencia": {
"type": [
"string",
"null"
],
"description": "Data ou mês de referência do registro."
},
"dataMesCompetencia": {
"type": [
"string",
"null"
],
"description": "Data ou mês de competência do registro."
}
}
},
"description": "Lista de benefícios registrados."
},
"beneficioConcedidoJudicialmente": {
"type": [
"boolean",
"null"
],
"description": "Indica se o benefício foi concedido por via judicial."
}
},
"description": "Dados retornados da consulta de benefício."
},
"metaDados": {
"type": [
"object",
"null"
],
"properties": {
"ip": {
"type": [
"string",
"null"
],
"description": "Endereço IP da requisição."
},
"data": {
"type": [
"string",
"null"
],
"description": "Data e hora da execução da consulta."
},
"chave": {
"type": [
"string",
"null"
],
"description": "Chave de identificação da consulta."
},
"usuario": {
"type": [
"string",
"null"
],
"description": "Usuário que realizou a consulta."
},
"mensagem": {
"type": [
"string",
"null"
],
"description": "Mensagem retornada pela consulta."
},
"apiVersao": {
"type": [
"string",
"null"
],
"description": "Versão da API utilizada."
},
"resultado": {
"type": [
"string",
"null"
],
"description": "Status ou descrição do resultado da consulta."
},
"assincrono": {
"type": [
"boolean",
"null"
],
"description": "Indica se a consulta foi executada de forma assíncrona."
},
"consultaUid": {
"type": [
"string",
"null"
],
"description": "Identificador único da consulta."
},
"resultadoId": {
"type": [
"number",
"null"
],
"description": "Identificador numérico do resultado."
},
"consultaNome": {
"type": [
"string",
"null"
],
"description": "Nome da consulta realizada."
},
"enviarCallback": {
"type": [
"boolean",
"null"
],
"description": "Indica se um callback será enviado."
},
"urlComprovante": {
"type": [
"string",
"null"
],
"description": "URL para acessar o comprovante gerado."
},
"tempoExecucaoMs": {
"type": [
"number",
"null"
],
"description": "Tempo de execução da consulta em milissegundos."
},
"gerarComprovante": {
"type": [
"boolean",
"null"
],
"description": "Indica se um comprovante será gerado."
}
},
"description": "Metadados da consulta."
}
}
}
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, um documento — Cada chamada deve solicitar dados de uma única pessoa, seja via CPF ou NIS.
Dados padronizados — As informações são mantidas em padrão consistente, facilitando integração com sistemas internos.
Sem comprovantes — A consulta retorna apenas informações cadastrais; documentos comprobatórios devem ser obtidos através de canais apropriados.
Latência de atualização — Os dados refletem o estado atual do registro, porém pode haver pequeno delay entre mudanças na fonte original e atualização nesta consulta.
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.