API CPF LIGHT – Versão 2.5.

Sumário
API CPF LIGHT ................................................................................................................................ 1
Consulta/CPF ................................................................................................................................. 1
Consulta/dados-cadastrais ............................................................................................................ 4
Consulta/dados-sensiveis .............................................................................................................. 5
Consulta/identificacao .................................................................................................................. 5
Consulta/nacionalidade-naturalidade........................................................................................... 6
Consulta/ocupacao ....................................................................................................................... 6
Consulta/localizacao ..................................................................................................................... 7
Consulta/telemovel ....................................................................................................................... 7
Consulta/domicilio-fiscal ............................................................................................................... 8

API CPF LIGHT

Serviço de Consultas On-line, que consiste em prover acesso aos dados não protegidos por
sigilo fiscal constantes de base de dados da Secretaria da Receita Federal do Brasil (RFB), para
órgãos e entidades da Administração Pública Federal direta, autárquica e fundacional nos
termos da Portaria RFB nº 1384, de 09 de setembro de 2016.

Consulta/CPF
Consulta os dados completos de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
Nome string Nome do cidadão - Sim
Se estiver vazio, neste caso, a
situação cadastral constará
como “3. suspensa”
NomeSocial string Nome social do cidadão Sim

Obs: Esse campo só é

preenchido para pessoas
travestis e transsexuais que
solicitam a inclusão por meio
de formulário específico.
Portanto se não for o caso, o
campo estará vazio.

Se estiver preenchido, deve

ser por esse campo que o
cidadão deverá ser chamado.

1
API CPF LIGHT – Versão 2.5.0
SituacaoCadastral
ResidenteExterior
CodigoPaisExterior
NomePaisExterior
string Situação do CPF na Receita: Sim
0. Regular - quando não há
inconsistência cadastral e não
constar omissão de
DIRPF;Obs.:
excepcionalmente, pode
ocorrer de existir um CPF
regular com inconsistência
ainda não detectada ou
tratada.
2. Suspensa - quando há
inconsistência de ordem
cadastral;
3 - Titular Falecido - quando
há data de óbito vinculada ao
CPF;
4. Pendente de Regularização -
quando há omissão de DIRPF
em um dos últimos 5
exercícios;
5. Cancelada por
Multiplicidade - quando há
mais de uma inscrição no CPF
para a mesma pessoa; nesse
caso, elege-se um para
permanecer ativo e os demais
são vinculados a ele;
8. Nula - quando constatada a
fraude.
9. Cancelada de Ofício - ato de
ofício, no interesse da
administração tributária ou
determinação judicial.
Cada serviço público deverá
definir qual situação cadastral
será aceita.
string N - Não; S - Sim Não
O endereço não fica vazio (ele
é preenchido com dados do
endereço no exterior) e o CEP
informado sempre será
70.000-000.
string Código do país se residente no Não
exterior (tabela própria da
Receita)
string Nome do país se residente no Não
exterior (tabela própria da
Receita)
2
API CPF LIGHT – Versão 2.5.0

NomeMae string Nome da mãe do cidadão - Sim

pode estar vazio, neste caso, a
situação cadastral constará
como “3. suspensa”
DataNascimento string AAAAMMDD - Sim
pode estar vazio, neste caso, a
situação cadastral constará
como “3. suspensa”
Sexo integer 1 - Masculino; Sim
2 - Feminino;
3 - Não Informado
NaturezaOcupacao string Código da natureza da Não
ocupação
NomeNaturezaOcupacao string Nome da natureza da Não
ocupação
(tabela própria da Receita)
OcupacaoPrincipal string Código da ocupação principal Não
(tabela própria da Receita)
NomeOcupacaoPrincipal string Nome da ocupação principal Não
(tabela própria da Receita)
ExercicioOcupacao string Ano do exercício da ocupação Não
(tabela própria da Receita)
NomeUnidadeAdministrativa string Nome da unidade Não
administrativa
(tabela própria da Receita)
TipoLogradouro string Tipo do logradouro Não
Logradouro string Ex: Rua A Não
NumeroLogradouro string Ex: 123 Não
Complemento string Ex: CONJ 132 Não
Bairro string Ex: Álvaro Weyne Não
Cep integer Ex: 70000000 Não
UF string Ex: CE Não
CodigoMunicipio integer Ex: 1234 Não

Trata-se de código de tabela

da RFB, a tabela TOM (órgãos
e municípios)
Dessa tabela deriva a
jurisdição tributária do
contribuinte.
Municipio string Ex: Fortaleza Não
DDD integer Ex: 85 Não
Telefone string Ex: 95585862 Não
UnidadeAdministrativa integer Ex: 806030 Não

Este campo se refere a

unidade administrativa da
Receita o qual o contribuinte
deve se dirigir para tratar
assuntos fiscais

3
API CPF LIGHT – Versão 2.5.0

AnoObito integer AAAA Sim

Está integrado com os

cartórios, mas não possuem a
informação de dados legados.
Deve ser feito batimento com
o SIRC.
Estrangeiro string N - Não; S - Sim Não
DataAtualização string AAAAMMDD Sim
DataInscricao string AAAAMMDD Sim
CodPaisNacionalidade string Código do país onde o cidadão Sim
nasceu
(conforme tabela da RFB)
NomePaisNacionalidade string Nome do país onde o cidadão Sim
nasceu
(conforme tabela da RFB)
CodigoMunicipioNaturalidade string Código do município onde o Não
cidadão nasceu
(conforme tabela da RFB)
NomeMunicipioNaturalidade string Nome do município onde o Sim
cidadão nasceu
(conforme tabela da RFB)
UFMunicipioNaturalidade string Sigla da UF do município onde Não
o cidadão nasceu
(conforme tabela da RFB)
Observação: Atualmente existem CPFs com nome, nome da mãe ou data de nascimento
vazios. CPFs nessa situação constarão na situação cadastral como “3. Suspenso”.

Consulta/dados-cadastrais
Retorna os dados cadastrais dos CPFs consultados

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
SituacaoCadastral string Situação do CPF na Receita: Sim
0. Regular - quando não há
inconsistência cadastral e não
constar omissão de
DIRPF;Obs.:
excepcionalmente, pode
ocorrer de existir um CPF
regular com inconsistência
ainda não detectada ou
tratada.
2. Suspensa - quando há
inconsistência de ordem
cadastral;
3 - Titular Falecido - quando
há data de óbito vinculada ao
CPF;
4. Pendente de Regularização -
quando há omissão de DIRPF

4
API CPF LIGHT – Versão 2.5.0

em um dos últimos 5
exercícios;
5. Cancelada por
Multiplicidade - quando há
mais de uma inscrição no CPF
para a mesma pessoa; nesse
caso, elege-se um para
permanecer ativo e os demais
são vinculados a ele;
8. Nula - quando constatada a
fraude.
9. Cancelada de Ofício - ato de
ofício, no interesse da
administração tributária ou
determinação judicial.

Cada serviço público deverá

definir qual situação cadastral
será aceita.
DataAtualização string AAAAMMDD Sim
DataInscricao string AAAAMMDD Sim

Consulta/dados-sensiveis
Consulta os dados sensíveis de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
Sexo integer 1 - Masculino; Sim
2 - Feminino;
3 - Não Informado

Consulta/identificacao
Consulta os dados de identificação de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
Nome string Nome do cidadão - Sim
Se estiver vazio, neste caso, a
situação cadastral constará
como “3. suspensa”
NomeSocial string Nome social do cidadão Sim

Obs: Esse campo só é

preenchido para pessoas
travestis e transsexuais que
solicitam a inclusão por meio
de formulário específico.
Portanto se não for o caso, o
campo estará vazio.

5
API CPF LIGHT – Versão 2.5.0

Se estiver preenchido, deve

ser por esse campo que o
cidadão deverá ser chamado.
NomeMae string Nome da mãe do cidadão - Sim
pode estar vazio, neste caso, a
situação cadastral constará
como “3. suspensa”
DataNascimento string AAAAMMDD - Sim
pode estar vazio, neste caso, a
situação cadastral constará
como “3. suspensa”
AnoObito integer AAAA Sim

Está integrado com os

cartórios, mas não possuem a
informação de dados legados.
Deve ser feito batimento com
o SIRC.
Estrangeiro string N - Não; S - Sim Não

Consulta/nacionalidade-naturalidade
Consulta os dados de nacionalidade e naturalidade de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
CodPaisNacionalidade string Código do país onde o cidadão Sim
nasceu
(conforme tabela da RFB)
NomePaisNacionalidade string Nome do país onde o cidadão Sim
nasceu
(conforme tabela da RFB)
CodigoMunicipioNaturalidade string Código do município onde o Não
cidadão nasceu
(conforme tabela da RFB)
NomeMunicipioNaturalidade string Nome do município onde o Sim
cidadão nasceu
(conforme tabela da RFB)
UFMunicipioNaturalidade string Sigla da UF do município onde Não
o cidadão nasceu
(conforme tabela da RFB)

Consulta/ocupacao
Consulta os dados de ocupação de uma lista de cidadãos

6
API CPF LIGHT – Versão 2.5.0

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
NaturezaOcupacao string Código da natureza da Não
ocupação
NomeNaturezaOcupacao string Nome da natureza da Não
ocupação
(tabela própria da Receita)
OcupacaoPrincipal string Código da ocupação principal Não
(tabela própria da Receita)
NomeOcupacaoPrincipal string Nome da ocupação principal Não
(tabela própria da Receita)
ExercicioOcupacao string Ano do exercício da ocupação Não
(tabela própria da Receita)

Consulta/localizacao
Consulta os dados de localização de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
ResidenteExterior string N - Não; S - Sim Não

O endereço não fica vazio (ele

é preenchido com dados do
endereço no exterior) e o CEP
informado sempre será
70.000-000.
CodigoPaisExterior string Código do país se residente no Não
exterior (tabela própria da
Receita)
NomePaisExterior string Nome do país se residente no Não
exterior (tabela própria da
Receita)
TipoLogradouro string Tipo do logradouro Não
Logradouro string Ex: Rua A Não
NumeroLogradouro string Ex: 123 Não
Complemento string Ex: CONJ 132 Não
Bairro string Ex: Álvaro Weyne Não
Cep integer Ex: 70000000 Não
UF string Ex: CE Não

Consulta/telemovel
Consulta os dados de telefonia de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim

7
API CPF LIGHT – Versão 2.5.0

DDD integer Ex: 85 Não

Telefone string Ex: 95585862 Não

Consulta/domicilio-fiscal
Consulta os dados de domicílio fiscal de uma lista de cidadãos

CAMPO TIPO DESCRIÇÃO ESTÁ NO CBC?

CPF string CPF do cidadão Sim
NomeUnidadeAdministrativa string Nome da unidade Não
administrativa
(tabela própria da Receita)
CodigoMunicipio integer Ex: 1234 Não

Trata-se de código de tabela

da RFB, a tabela TOM (órgãos
e municípios)
Dessa tabela deriva a
jurisdição tributária do
contribuinte.
Municipio string Ex: Fortaleza Não
UnidadeAdministrativa integer Ex: 806030 Não

Este campo se refere a

unidade administrativa da
Receita o qual o contribuinte
deve se dirigir para tratar
assuntos fiscais