Dados cadastrais

Dados Cadastrais Básicos

O serviço de Dados Cadastrais Básicos retorna informações como CNPJ, razão social e data de fundação, obtidas de fontes oficiais.

Falar com o comercial Ver o catálogo

Quando usar

Descrição

O serviço de Dados Cadastrais Básicos fornece informações cadastrais essenciais, como CNPJ, razão social, nome fantasia e data de fundação, obtidas de fontes oficiais.

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/dados-cadastrais-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
`BasicData.TaxIdNumber`	texto
`BasicData.TaxIdCountry`	texto
`BasicData.OfficialName`	texto
`BasicData.TradeName`	texto
`BasicData.Aliases.UnstandardizedRFOfficialName`	texto
`BasicData.Aliases.UnstandardizedRFTradeName`	texto
`BasicData.NameUniquenessScore`	número
`BasicData.OfficialNameUniquenessScore`	número
`BasicData.TradeNameUniquenessScore`	número
`BasicData.FoundedDate`	data
`BasicData.Age`	número
`BasicData.IsHeadquarter`	booleano
`BasicData.HeadquarterState`	texto
`BasicData.IsConglomerate`	booleano
`BasicData.TaxIdStatus`	texto
`BasicData.TaxIdOrigin`	texto
`BasicData.TaxIdStatusDate`	data
`BasicData.TaxIdStatusRegistrationDate`	data
`BasicData.TaxRegime`	texto
`BasicData.CompanyType_ReceitaFederal`	texto
`BasicData.TaxRegimes.Simples`	booleano
`BasicData.Activities[].IsMain`	booleano
`BasicData.Activities[].Code`	texto
`BasicData.Activities[].Activity`	texto
`BasicData.LegalNature.Code`	texto
`BasicData.LegalNature.Activity`	texto
`BasicData.SpecialSituation`	texto
`BasicData.CreationDate`	data
`BasicData.LastUpdateDate`	data
`BasicData.AdditionalOutputData.Capital`	texto
`BasicData.AdditionalOutputData.CapitalRS`	texto
`BasicData.AdditionalOutputData.NIRE`	texto
`BasicData.AdditionalOutputData.NIRECompanySize`	texto
`BasicData.AdditionalOutputData.NIREHeadquartersType`	texto
`BasicData.AdditionalOutputData.NIREHeadquartersCapital`	texto
`BasicData.AdditionalOutputData.NIRELastCaptureDate`	data
`BasicData.AdditionalOutputData.COMEX`	texto
`BasicData.AdditionalOutputData.COMEXLastUpdate`	data
`BasicData.HistoricalData.HasChangedTradeName`	booleano
`BasicData.HistoricalData.HasChangedTaxRegime`	booleano
`BasicData.HistoricalData.HistoricalDataEvolution.TaxRegime[].Value`	texto
`BasicData.HistoricalData.HistoricalDataEvolution.TaxRegime[].StartDate`	data
`BasicData.HistoricalData.HistoricalDataEvolution.TaxRegime[].EndDate`	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": "Dados Cadastrais Básicos",
  "query_slug": "dados-cadastrais-basicos",
  "data": {
    "BasicData": {
      "TaxIdNumber": "texto",
      "TaxIdCountry": "texto",
      "AlternativeIdNumbers": {
      },
      "OfficialName": "texto",
      "TradeName": "texto",
      "Aliases": {
        "UnstandardizedRFOfficialName": "texto",
        "UnstandardizedRFTradeName": "texto"
      },
      "NameUniquenessScore": 0,
      "OfficialNameUniquenessScore": 0,
      "TradeNameUniquenessScore": 0,
      "FoundedDate": "2026-01-01",
      "Age": 0,
      "IsHeadquarter": false,
      "HeadquarterState": "texto",
      "IsConglomerate": false,
      "TaxIdStatus": "texto",
      "TaxIdOrigin": "texto",
      "TaxIdStatusDate": "2026-01-01",
      "TaxIdStatusRegistrationDate": "2026-01-01",
      "TaxRegime": "texto",
      "CompanyType_ReceitaFederal": "texto",
      "TaxRegimes": {
        "Simples": false
      },
      "Activities": [
        {
          "IsMain": false,
          "Code": "texto",
          "Activity": "texto"
        }
      ],
      "LegalNature": {
        "Code": "texto",
        "Activity": "texto"
      },
      "SpecialSituation": "texto",
      "CreationDate": "2026-01-01",
      "LastUpdateDate": "2026-01-01",
      "AdditionalOutputData": {
        "Capital": "texto",
        "CapitalRS": "texto",
        "NIRE": "texto",
        "NIRECompanySize": "texto",
        "NIREHeadquartersType": "texto",
        "NIREHeadquartersCapital": "texto",
        "NIRELastCaptureDate": "2026-01-01",
        "COMEX": "texto",
        "COMEXLastUpdate": "2026-01-01"
      },
      "HistoricalData": {
        "HasChangedTradeName": false,
        "HasChangedTaxRegime": false,
        "HistoricalDataEvolution": {
          "TaxRegime": [
            {
              "Value": "texto",
              "StartDate": "2026-01-01",
              "EndDate": "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