Consulta básica CPF

A resposta contém os seguintes campos principais:

Identificação do titular:

• cpf: CPF consultado, somente dígitos
• nome: Nome completo conforme registro oficial
• sexo: Sexo informado no cadastro (M ou F)
• nacionalidade: Nacionalidade declarada (ex.: BRASILEIRA)

Dados de nascimento e idade:

• data_nascimento: Data de nascimento em formato ISO 8601 (UTC)
• idade: Idade atual calculada a partir da data de nascimento

Filiação:

• nome_mae: Nome da mãe do titular
• nome_pai: Nome do pai do titular (pode retornar string vazia quando não disponível)

Situação e registro do CPF:

• situacao_cadastral: Status atual do CPF (REGULAR, SUSPENSA, PENDENTE DE REGULARIZAÇÃO, CANCELADA ou NULA)
• obito: Indicador booleano de registro de óbito associado ao CPF
• uf_inscricao: UF ou conjunto de UFs da inscrição original (pode conter múltiplas siglas separadas por hífen, ex.: DF-GO-MS-MT-TO)
• data_inscricao_cpf: Data de emissão do CPF em formato ISO 8601 (UTC)

Recência do dado:

• atualizado_em: Data da última atualização deste registro na base consultada, no formato ISO 8601 de data (AAAA-MM-DD). Indica de quando é a informação entregue.

{
  "cpf": "string",
  "nome": "string",
  "sexo": "string",
  "idade": "number",
  "obito": "boolean",
  "nome_mae": "string",
  "nome_pai": "string",
  "uf_inscricao": "string",
  "atualizado_em": "string",
  "nacionalidade": "string",
  "data_nascimento": "string",
  "data_inscricao_cpf": "string",
  "data_nascimento_br": "string",
  "situacao_cadastral": "string"
}

{
  "type": "object",
  "properties": {
    "cpf": {
      "type": [
        "string",
        "null"
      ],
      "description": "CPF"
    },
    "nome": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome Completo da Pessoa"
    },
    "sexo": {
      "type": [
        "string",
        "null"
      ],
      "description": "Sexo da Pessoa Abreviado"
    },
    "idade": {
      "type": [
        "number",
        "null"
      ],
      "description": "Idade da pessoa em anos"
    },
    "obito": {
      "type": [
        "boolean",
        "null"
      ],
      "format": "bool",
      "description": "Existe registro de Óbito?"
    },
    "nome_mae": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome da Mãe da Pessoa"
    },
    "nome_pai": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nome do Pai da pessoa"
    },
    "uf_inscricao": {
      "type": [
        "string",
        "null"
      ],
      "description": "UF(s) de inscrição do CPF."
    },
    "atualizado_em": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Data da última atualização deste registro na base de origem (AAAA-MM-DD) — leia como a recência da informação entregue."
    },
    "nacionalidade": {
      "type": [
        "string",
        "null"
      ],
      "description": "Nacionalidade da Pessoa"
    },
    "data_nascimento": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de Nascimento"
    },
    "data_inscricao_cpf": {
      "type": [
        "string",
        "null"
      ],
      "format": "date",
      "description": "Data de inscrição do CPF na Receita Federal."
    },
    "data_nascimento_br": {
      "type": [
        "string",
        "null"
      ],
      "description": "Data de Nascimento (dd/mm/yyyy)"
    },
    "situacao_cadastral": {
      "type": [
        "string",
        "null"
      ],
      "description": "Situação cadastral do CPF da pessoa"
    }
  }
}

• Campos sem informação disponível no registro de origem são retornados como string vazia ("") em vez de null, o que ocorre com maior frequência no campo nome_pai.
• Nomes, especialmente os de filiação, podem vir truncados em função do tamanho máximo permitido no registro de origem, portanto não são recomendados para comparação exata de strings.
• As datas de nascimento e de inscrição seguem o padrão ISO 8601 com sufixo Z (UTC) e horário sempre 00:00:00Z, já que apenas a data tem significado. O campo atualizado_em é entregue como data pura (AAAA-MM-DD): a fonte às vezes informa horário, que não é significativo e por isso não é repassado.
• O campo uf_inscricao pode conter mais de uma UF concatenada quando o CPF foi emitido em uma região administrativa que agrupa vários estados.
• A ausência de indicativo de óbito (obito: false) não garante que o titular esteja vivo — significa apenas que não há registro confirmado na base consultada.
• CPFs com situação cadastral diferente de REGULAR devem receber tratamento específico no fluxo de negócio, pois indicam restrições ou pendências junto ao cadastro oficial.
• Para análises de identidade e conformidade mais completas, recomenda-se combinar este endpoint com outras consultas de enriquecimento e verificação cadastral.
• O campo atualizado_em diz quando este registro foi atualizado na base consultada: esta consulta serve o dado dessa base, não uma leitura ao vivo da Receita Federal. Se o seu caso exige o dado em TEMPO REAL, com comprovante emitido pela própria Receita (data/hora de emissão, código de controle e link de validação), use a consulta Cadastro Pessoal com Receita Federal.