---
title: "ConsultaCnpjViewModel"
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/schemas/ConsultaCnpjViewModel"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# ConsultaCnpjViewModel

Representa os dados detalhados resultantes de uma consulta de CNPJ.

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
components:
  schemas:
    ConsultaCnpjRegimeEnum:
      enum:
        - Mei
        - SimplesNacional
        - Normal
      type: string
      description: Regime do CNPJ na consulta.
    ConsultaCnpjCnaeViewModel:
      type: object
      properties:
        cnae:
          type: string
          description: Código numérico identificador do CNAE.
          nullable: true
        descricao:
          type: string
          description: Descrição textual da atividade econômica.
          nullable: true
      additionalProperties: false
      description: Representa uma Classificação Nacional de Atividade Econômica (CNAE).
    ConsultaCnpjEnderecoViewModel:
      type: object
      properties:
        logradouro:
          type: string
          description: Nome do logradouro (rua, avenida, praça, etc.).
          nullable: true
        numero:
          type: string
          description: Número do estabelecimento no logradouro.
          nullable: true
        complemento:
          type: string
          description: Informações adicionais para localização (Andar, Sala, Loja).
          nullable: true
        bairro:
          type: string
          description: Bairro ou distrito de localização.
          nullable: true
        codigoMunicipio:
          type: string
          description: Código IBGE identificador do município.
          nullable: true
        municipio:
          type: string
          description: Nome da cidade ou município.
          nullable: true
        uf:
          type: string
          description: Sigla da Unidade Federativa (Estado).
          nullable: true
        cep:
          type: string
          description: Código de Endereçamento Postal.
          nullable: true
      additionalProperties: false
      description: Representa o endereço completo de uma entidade.
    ConsultaCnpjSocioViewModel:
      type: object
      properties:
        qualificacao:
          type: string
          description: Descrição do cargo ou qualificação do sócio na empresa.
          nullable: true
        nome:
          type: string
          description: Nome completo ou razão social do sócio.
          nullable: true
        faixaEtaria:
          type: string
          description: Faixa etária estimada do sócio.
          nullable: true
      additionalProperties: false
      description: Representa um membro do quadro societário ou administrativo.
    ConsultaCnpjInscricaoViewModel:
      type: object
      properties:
        ie:
          type: string
          description: Número identificador da Inscrição Estadual.
          nullable: true
        uf:
          type: string
          description: Unidade Federativa onde a inscrição está registrada.
          nullable: true
        ativa:
          type: boolean
          description: Indica se a inscrição está em situação regular/ativa.
        possuiRestricao:
          type: boolean
          description: Indica se existe alguma pendência ou restrição fiscal.
        dataAtualizacaoStatus:
          type: string
          description: Data do último processamento de status da inscrição.
          format: date
          example: 2025-03-31
      additionalProperties: false
      description: Representa os detalhes de uma inscrição estadual.
    ConsultaCnpjViewModel:
      type: object
      properties:
        cnpj:
          type: string
          description: Número de inscrição no Cadastro Nacional da Pessoa Jurídica.
          nullable: true
        razaoSocial:
          type: string
          description: Nome empresarial ou razão social completa da entidade.
          nullable: true
        nomeFantasia:
          type: string
          description: Nome fantasia ou título do estabelecimento, se houver.
          nullable: true
        naturezaJuridica:
          type: string
          description: Descrição da natureza jurídica da organização.
          nullable: true
        regime:
          $ref: "#/components/schemas/ConsultaCnpjRegimeEnum"
        dataAbertura:
          type: string
          description: Data oficial de abertura da empresa.
          format: date
          example: 2025-03-31
        status:
          type: string
          description: "Situação cadastral atual (Ex: Ativa, Baixada, Suspensa)."
          nullable: true
        ultimaAlteracaoStatus:
          type: string
          description: Data da última atualização da situação cadastral.
          format: date
          nullable: true
        telefones:
          type: array
          items:
            type: string
          description: Lista de números de telefone para contato.
          nullable: true
        emails:
          type: array
          items:
            type: string
          description: Lista de endereços de e-mail para contato.
          nullable: true
        atividadePrincipal:
          $ref: "#/components/schemas/ConsultaCnpjCnaeViewModel"
        atividadesSecundarias:
          type: array
          items:
            $ref: "#/components/schemas/ConsultaCnpjCnaeViewModel"
          description: Lista de atividades econômicas secundárias exercidas.
          nullable: true
        endereco:
          $ref: "#/components/schemas/ConsultaCnpjEnderecoViewModel"
        socios:
          type: array
          items:
            $ref: "#/components/schemas/ConsultaCnpjSocioViewModel"
          description: Quadro de sócios e administradores da empresa.
          nullable: true
        inscricoesEstaduais:
          type: array
          items:
            $ref: "#/components/schemas/ConsultaCnpjInscricaoViewModel"
          description: Lista de inscrições estaduais vinculadas ao CNPJ por UF.
          nullable: true
      additionalProperties: false
      description: Representa os dados detalhados resultantes de uma consulta de CNPJ.
```