Observação: para mais informações, consulte o Manual de Dados.
Operação
|
Descrição
|
Campos Retornados
|
Consulta CPF
|
Consulta os dados completos de uma lista de cidadãos
|
CPF, Nome, NomeSocial, SituacaoCadastral, ResidenteExterior, CodigoPaisExterior,
NomePaisExterior, NomeMae, DataNascimento, Sexo, NaturezaOcupacao,
NomeNaturezaOcupacao, OcupacaoPrincipal, NomeOcupacaoPrincipal,
ExercicioOcupacao, NomeUnidadeAdministrativa, TipoLogradouro,
Logradouro, NumeroLogradouro, Complemento, Bairro, Cep, UF, CodigoMunicipio,
Municipio, DDD, Telefone, UnidadeAdministrativa, AnoObito, Estrangeiro,
DataAtualização, DataInscricao, CodPaisNacionalidade, NomePaisNacionalidade,
CodigoMunicipioNaturalidade, NomeMunicipioNaturalidade
UFMunicipioNaturalidade
|
Consulta dados cadastrais
|
Retorna os dados cadastrais dos CPFs consultados
|
CPF, SituacaoCadastral, DataAtualização, DataInscricao
|
Consulta dados sensíveis
|
Consulta os dados sensíveis de uma lista de cidadãos
|
CPF, Sexo
|
Consulta identificação
|
Consulta os dados de identificação de uma lista de cidadãos
|
CPF, Nome, NomeSocial, NomeMae, DataNascimento, AnoObito, Estrangeiro
|
Consulta nacionalidade/ naturalidade
|
Consulta os dados de nacionalidade e naturalidade de uma lista de cidadãos
|
CPF, CodPaisNacionalidade, NomePaisNacionalidade,
CodigoMunicipioNaturalidade, NomeMunicipioNaturalidade,
UFMunicipioNaturalidade
|
Consulta ocupação
|
Consulta os dados de ocupação de uma lista de cidadãos
|
CPF, NaturezaOcupacao, NomeNaturezaOcupacao,
OcupacaoPrincipal, NomeOcupacaoPrincipal,
ExercicioOcupacao
|
Consulta localização
|
Consulta os dados de localização de uma lista de cidadãos
|
CPF, ResidenteExterior, CodigoPaisExterior, NomePaisExterior,
TipoLogradouro, Logradouro, NumeroLogradouro, Complemento, Bairro,
Cep, UF
|
Consulta telemóvel
|
Consulta os dados de telefonia de uma lista de cidadãos
|
CPF, DDD, Telefone
|
Consulta domicílio fiscal
|
Consulta os dados de domicílio fiscal de uma lista de cidadãos
|
CPF, NomeUnidadeAdministrativa, CodigoMunicipio, Municipio, UnidadeAdministrativa
|
- Cadastro Base do Cidadão (CBC)
- Cadastro de Pessoas Físicas (CPF)
1. Para o cidadão
APIs são a base para a troca automática e segura de informações entre os sistemas e não estão disponíveis para acesso pelo cidadão.
Caso esteja com dificuldade em acessar sua conta gov.br, tente recuperá-la seguindo os passos nesta página ou abra uma solicitação no Atendimento ao usuário – Conta GOV.BR.
Caso a dificuldade seja no reconhecimento facial do aplicativo gov.br, reinstale o aplicativo gov.br no celular e tente realizar o procedimento novamente.
Para demais problemas, envie um e-mail para atendimentogovbr@economia.gov.br e você receberá instruções gerais sobre como solucionar problemas mais comuns. Fique atento à caixa de spam ou "lixo eletrônico".
2. Para órgãos não SISP
Para utilizar a API, é necessário que o órgão solicitante faça parte do Sistema de Administração dos Recursos de Tecnologia da Informação (SISP). Para saber se o seu órgão faz parte, acesse: https://www.gov.br/governodigital/pt-br/sisp.
3. Para a iniciativa privada
O acesso à API pelo Programa Conecta gov.br está disponível apenas para órgãos do SISP.
4. Para órgãos SISP
Caso o órgão solicitante faça parte do SISP e deseje utilizar a API, é preciso realizar a adesão ao Programa Conecta gov.br e obter a autorização do órgão cedente dos dados Receita Federal - RFB, de acordo com os seguintes passos:
4.1. Indique seu interesse.
Indique seu interesse enviando um e-mail para o endereço conecta@economia.gov.br.
4.2. Preencha, assine e encaminhe a adesão
Você receberá a minuta do ofício de adesão ao Conecta, que deverá ser preenchida, assinada e devolvida para o endereço do e-mail recebido. Ressaltamos os seguintes pontos relativos ao ofício de adesão:
- é preciso a definição clara da finalidade do uso dos dados, de acordo com a Lei Geral de Proteção de Dados Pessoais (LGPD);
- não é necessária a análise jurídica;
- deve ser assinado pelo Dirigente de TI e Responsável Técnico;
- deve haver definição da volumetria anual desejada (de 01/01 a 31/12);
- o ofício de adesão pode incluir outras APIs disponibilizadas pelo Conecta.
4.3. Esclareça eventuais dúvidas
O Conecta enviará sua solicitação de autorização de acesso para o órgão cedente dos dados que poderá entrar em contato direto com o órgão solicitante para esclarecer eventuais dúvidas pertinentes à autorização.
4.4. Receba o resultado da solicitação
Após análise do órgão cedente, o Conecta enviará e-mail com ofício indicando se a solicitação de autorização de acesso à API foi deferida ou não. Em caso de deferimento, serão enviadas também orientações técnicas para acesso à plataforma e geração da chave de acesso para consumo da API. Em caso de indeferimento, o órgão receberá a justificativa.
Endpoint Produção:
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/cpf
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/dados-cadastrais
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/dados-sensiveis
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/identificao
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/nacionalidade-naturalidade
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/ocupacao
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/localizacao
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/telemovel
https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/domicilio-fiscal
Endpoint Homologação:
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/cpf
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/dados-cadastrais
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/dados-sensiveis
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/identificao
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/nacionalidade-naturalidade
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/ocupacao
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/localizacao
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/telemovel
https://h-apigateway.conectagov.estaleiro.serpro.gov.br/api-cpf-light/v2/consulta/domicilio-fiscal
Requisitos de acesso/autorização
A API exige chave de acesso para sua utilização. O integrante responsável indicado pelo órgão deverá gerar a chave de acesso após autenticação pelo acesso.gov.br utilizando certificado digital tipo A e mediante assinatura de Termo de Responsabilidade.
Para obtenção de acesso e demais orientações para integração das aplicações à API, veja o passo a passo no Gerenciador de APIs do Conecta.
Área responsável
Diretoria de Infraestrutura de Dados - DEDAD/SGD/MGI
Função do Contato
Área Negocial
E-mail
conecta@economia.gov.br
Telefone
(61) 2020-2088/2255
Horário de atendimento
Das 08h às 18h
Área responsável
Departamento de Soluções de Governo Digital - SERPRO
Função do Contato
Área Técnica
E-mail
lista-sungd-gdtgd@grupos.serpro.gov.br
Telefone
(61) 2021-7857
Horário de atendimento
Das 08h às 18h