Dados cadastrais

Dados Cadastrais Básicos

O serviço de Dados Cadastrais Básicos retorna informações cadastrais básicas, como nome, CPF, nome da mãe e data de nascimento.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Dados Cadastrais Básicos reúne as informações cadastrais mais essenciais, obtidas de fontes oficiais e complementadas por inferências e outros dados relacionados.

Entre as informações fornecidas estão o nome, CPF, nome da mãe e data de nascimento.

Requisição

Autenticação por chave de API (cabeçalho Authorization: Bearer), criada no painel com esta consulta no escopo.

POST /api/v1/{tenant}/pessoas/dados-cadastrais-basicos

Campo	Obrigatório	Descrição
`document`	sim	CPF da pessoa, com ou sem máscara.
`birthdate`	não	Data de nascimento

{
  "document": "000.000.000-00",
  "birthdate": "valor"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`Age`	número
`Name`	texto
`Gender`	texto
`Aliases.CommonName`	texto
`Aliases.StandardizedName`	texto
`BirthDate`	data
`FatherName`	texto
`MotherName`	texto
`ZodiacSign`	texto
`ChineseSign`	texto
`TaxIdNumber`	texto
`TaxIdOrigin`	texto
`TaxIdStatus`	texto
`BirthCountry`	texto
`CreationDate`	data
`TaxIdCountry`	texto
`NameWordCount`	número
`LastUpdateDate`	data
`TaxIdStatusDate`	data
`HasObitIndication`	booleano
`TaxIdFiscalRegion`	texto
`NameUniquenessScore`	número
`AlternativeIdNumbers.SocialSecurityNumber`	texto
`FirstNameUniquenessScore`	número
`NumberOfFullNameNamesakes`	número
`TaxIdStatusRegistrationDate`	data
`FirstAndLastNameUniquenessScore`	número

Exemplo de resposta

Estrutura real da resposta, com valores fictícios.

{
  "execution_id": "00000000-0000-0000-0000-000000000000",
  "status": "success",
  "message": "Consulta realizada com sucesso",
  "query_name": "Dados Cadastrais Básicos",
  "query_slug": "dados-cadastrais-basicos",
  "data": {
    "Age": 0,
    "Name": "texto",
    "Gender": "texto",
    "Aliases": {
      "CommonName": "texto",
      "StandardizedName": "texto"
    },
    "BirthDate": "2026-01-01",
    "FatherName": "texto",
    "MotherName": "texto",
    "ZodiacSign": "texto",
    "ChineseSign": "texto",
    "TaxIdNumber": "texto",
    "TaxIdOrigin": "texto",
    "TaxIdStatus": "texto",
    "BirthCountry": "texto",
    "CreationDate": "2026-01-01",
    "TaxIdCountry": "texto",
    "NameWordCount": 0,
    "LastUpdateDate": "2026-01-01",
    "TaxIdStatusDate": "2026-01-01",
    "HasObitIndication": false,
    "MaritalStatusData": {
    },
    "TaxIdFiscalRegion": "texto",
    "NameUniquenessScore": 0,
    "AlternativeIdNumbers": {
      "SocialSecurityNumber": "texto"
    },
    "FirstNameUniquenessScore": 0,
    "NumberOfFullNameNamesakes": 0,
    "TaxIdStatusRegistrationDate": "2026-01-01",
    "FirstAndLastNameUniquenessScore": 0
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.060"
}

Cobrança e respostas

O valor é cobrado por consulta bem-sucedida.
200 — consulta processada (veja status no corpo da resposta)
401 — token ausente, inválido, inativo ou expirado
403 — serviço fora do escopo da chave, IP não autorizado ou limite de consumo excedido
422 — campo obrigatório ausente/inválido ou payload acima do limite do serviço
429 — limite de requisições por minuto da chave excedido
504 — tempo máximo de execução do serviço excedido