Orientações e respostas da equipe da Direct Data

INSS - Instituto Nacional do Seguro Social

Verifica se o CPF informado é de uma entidade que possuí aposentadoria no Instituto Nacional do Seguro Social.


Casos de Uso

  • Integração com INSS - Instituto Nacional do Seguro Social
  • Validação e padronização de dados cadastrais
  • Automação de consultas para decisões operacionais
  • Integração com fluxos de risco, crédito e compliance

Aplicações

  • Análise de Risco/Crédito
  • Compliance/ESG

Benefícios

  • Documentação de INSS - Instituto Nacional do Seguro Social acessível e atualizada
  • Reduz custos e erros manuais
  • Aumenta confiabilidade das decisões
  • Integração simples e escalável

A API INSS (Instituto Nacional do Seguro Social) permite verificar se o CPF informado é de uma entidade que possui aposentadoria no Instituto Nacional do Seguro Social.

URL Base

A API está hospedada no seguinte endereço:

https://apiv3.directd.com.br/api/InstitutoNacionalSeguroSocial

Endpoint

GET https://apiv3.directd.com.br/api/InstitutoNacionalSeguroSocial?Cpf={0}&Token=Seu_Token

Descrição: Endpoint para realizar consultas INSS - Instituto Nacional do Seguro Social.

Nota: Esta consulta não gera comprovantes.

Campos Retornados

  • CPF: CPF do indivíduo
  • Flag Possível Aposentado: Informa se o indivíduo possui ou não aposentadoria. True(verdadeiro) ou false(falso)
  • Nome: Nome do indivíduo/registro
  • Status: Retorna detalhes sobre o status do registro em questão

Parâmetros

ParâmetroTipoObrigatórioDescrição
CPFstring
Sim

O parâmetro CPF pode ser enviado com ou sem formatação.

TOKENstring
Sim

O parâmetro TOKEN é essencial para efetuar esta consulta. Em caso de dúvidas, por favor, entre em contato com: suporte@directd.com.br

Exemplo de Resposta

{
  "metaDados": {
    "consultaNome": "string",
    "consultaUid": "string",
    "chave": "string",
    "usuario": "string",
    "mensagem": "string",
    "ip": "string",
    "resultadoId": 0,
    "resultado": "string",
    "apiVersao": "v3",
    "enviarCallback": false,
    "gerarComprovante": false,
    "urlComprovante": "string",
    "assincrono": true,
    "data": "dd/MM/yyyy HH:mm:ss",
    "tempoExecucaoMs": 0
  },
  "retorno": {
    "cpf": "string",
    "nome": "string",
    "possivelAposentado": true,
    "status": "string"
  }
}

Erros Comuns

CódigoDescrição
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.

Notas Importantes

  • Para utilizar a consulta de forma assíncrona, utiliza-se: '&async=habilitar' na URL
  • Em caso de dúvidas/suporte, entre em contato pelo e-mail: suporte@directd.com.br ou pelo nosso WhatsApp: (11) 93906-9228