Dados cadastrais

Histórico de Dados Básicos

O serviço de Histórico de Dados Básicos retorna alterações em dados como nome, regime tributário e CNAE ao longo do tempo para o CNPJ consultado.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Histórico de Dados Básicos fornece listas de alterações em informações essenciais da empresa ao longo do tempo, como mudanças de nome, regime tributário e CNAE.

Também são fornecidos dados agregados como idade da empresa, quantidade total de alterações e data da última modificação capturada.

Requisição

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

POST /api/v1/{tenant}/empresas/historico-de-dados-basicos

Campo	Obrigatório	Descrição
`document`	sim	CNPJ da empresa, com ou sem máscara.

{
  "document": "00.000.000/0000-00"
}

Campos de retorno

Campos dentro de data. [] indica lista.

Campo	Tipo
`CurrentName`	texto
`Age`	número
`TotalChanges`	número
`NameTotalChanges`	número
`TaxRegimeTotalChanges`	número
`HeadquarterTotalChanges`	número
`CnaeTotalChanges`	número
`LastDateChanged`	data
`LastNameChanged`	data
`LastLegalNatureChanged`	data
`NameHistoryList[].Name`	texto
`NameHistoryList[].TradeName`	texto
`NameHistoryList[].OfficialName`	texto
`NameHistoryList[].ChangeDate`	data
`TaxRegimeHistoryList[].TaxRegime`	texto
`TaxRegimeHistoryList[].ChangeDate`	data
`CnaeHistoryList[].Code`	texto
`CnaeHistoryList[].DocNumber`	texto
`CnaeHistoryList[].Activity`	texto
`CnaeHistoryList[].EconomicActivityDivision`	texto
`CnaeHistoryList[].EconomicActivityGroup`	texto
`CnaeHistoryList[].IsMainEconomicActivity`	booleano
`CnaeHistoryList[].ChangeDate`	data

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": "Histórico de Dados Básicos",
  "query_slug": "historico-de-dados-basicos",
  "data": {
    "CurrentName": "texto",
    "Age": 0,
    "TotalChanges": 0,
    "NameTotalChanges": 0,
    "TaxRegimeTotalChanges": 0,
    "HeadquarterTotalChanges": 0,
    "CnaeTotalChanges": 0,
    "LastDateChanged": "2026-01-01",
    "LastNameChanged": "2026-01-01",
    "LastLegalNatureChanged": "2026-01-01",
    "NameHistoryList": [
      {
        "Name": "texto",
        "TradeName": "texto",
        "OfficialName": "texto",
        "ChangeDate": "2026-01-01"
      }
    ],
    "TaxRegimeHistoryList": [
      {
        "TaxRegime": "texto",
        "ChangeDate": "2026-01-01"
      }
    ],
    "CnaeHistoryList": [
      {
        "Code": "texto",
        "DocNumber": "texto",
        "Activity": "texto",
        "EconomicActivityDivision": "texto",
        "EconomicActivityGroup": "texto",
        "IsMainEconomicActivity": false,
        "ChangeDate": "2026-01-01"
      }
    ]
  },
  "consulted_at": "2026-01-01T12:00:00Z",
  "query_cost": "0.040"
}

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