• Funcionalidades do Sistema
Catálogo de APIs Governamentais
APIS em Destaque

Consulta de Benefícios Previdenciários

Instituto Nacional do Seguro Social (INSS)

Versão 2.3.2 - 25/10/2022

Base / Sistema: Cadastro de Benefícios do INSS

Disponível via Conecta
Federal

O cadastro de Benefícios do Regime Geral de Previdência Social é gerido pelo INSS e operacionalizado pela Empresa de Tecnologia e Informações da Previdência – Dataprev.
Utilizando como base as informações contidas no cadastro de benefícios do INSS, a API Benefícios tem como finalidade retornar uma lista de benefícios com principais atributos para a pessoa pesquisada. Os benefícios podem ser de diversas espécies, em que cada uma representa a classificação do tipo do benefício com suas regras e peculiaridades e é representada por um código numérico de 2 posições.


A API otimiza o tempo que o cidadão levaria para informar os benefícios percebidos por ele, bem como o tempo que o órgão levaria para validar as informações coletadas.

Principais Operações

Consulta a Benefícios por CPF
GET https://apigateway.conectagov.estaleiro.serpro.gov.br/api-beneficios-previdenciarios/v3/beneficios?cpf=
Parâmetros de Entrada CPF

Número do CPF a ser consultado

Código de Espécie (se informado, limitará a espécie informada)

Código da espécie do benefício

Código da Situação (se informado, limitará a situação informada)

Código da situação. De acordo com a tabela de situações.

Parâmetros de Saída Número do CPF encontrado

NIT do titular do benefício

Nome do Titular

Nome do titular do benefício

Nome da mãe do titular

Nome da mãe do titular do benefício

Gênero

Gênero do titular do benefício

Data de nascimento

Data de nascimento do titular do benefício

Número do Benefício (NB)

Número do benefício

Código da espécie de benefício

Código da espécie de benefício

Descrição da espécie do benefício

Descrição da espécie de benefício

Código da Situação

Código de situação do benefício

Descrição da Situação

Descrição da espécie de benefício

Data do início do benefício

Data do início do benefício

Data do fim do benefício

Data de cessação do benefício

Endpoints

Produção
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-beneficios-previdenciarios/v3/beneficios?cpf= https://apigateway.conectagov.estaleiro.serpro.gov.br/api-beneficios-previdenciarios/v3/beneficios/pertence-especie?cpf= https://apigateway.conectagov.estaleiro.serpro.gov.br/api-beneficios-previdenciarios/v3/beneficios/pertence-especie-87?cpf=

Para consultar a documentação técnica da API acesse: 

https://www.gov.br/conecta/catalogo/apis/api-beneficios-previdenciarios/Beneficios_previdenciarios.json/swagger_view

 

Atenção: Caso seja a primeira integração desenvolvida para acesso a uma API da Plataforma Conecta, é necessário previamente cadastrar os IPs do órgão para que se proceda a criação de regra de firewall no Serpro que permita o acesso à Plataforma.​

 

Atenção: Para geração das chaves de acesso, consulte a seção de Gestor Consumidor de APIs do Gerenciador Conecta em:

 

FAQ - Acesse o link abaixo se está com problema para acessar a API

https://www.gov.br/governodigital/pt-br/infraestrutura-nacional-de-dados/interoperabilidade/conecta-gov.br/acessar-os-servicos-do-conecta

Como Acessar

Para órgão Público Federal, siga as instruções de adesão ao Conecta gov.br

Quero acessar
Contato do Responsável

Diretoria de Benefícios do INSS (Gestor de Dados)

(61) 3313-4949

08h às 18h

Dataprev (Técnico)

08h às 18h