---
title: "Consultar dados do CNPJ."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-RecursosAdicionais-Cnpj-cnpj--Consultar/get"
---

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

# Consultar dados do CNPJ.

`GET` `/api/v1/RecursosAdicionais/Cnpj/{cnpj}/Consultar`

Realiza a busca de informações cadastrais detalhadas de uma pessoa jurídica junto às bases de dados oficiais. Este recurso é fundamental para a <strong>validação de emissores</strong> e garantia de que os dados cadastrais estão atualizados para a correta aplicação das regras fiscais. ⚠️ **ATENÇÃO**: A consulta retorna dados públicos do registro da empresa. Certifique-se de que o CNPJ informado esteje em formato válido para evitar erros de validação de máscara. 🧪 **TESTE**: Em ambiente de sandbox, a consulta pode retornar dados simplificados ou simulados para garantir a agilidade do desenvolvimento sem onerar bureaus de crédito ou bases governamentais reais.

## Path parameters

- `cnpj` (string, required) - CNPJ a ser consultado.

## Header parameters

- `DocumentoEmissor` (string, optional) - Documento do emissor.

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Not Found
- `429` - Too Many Requests
- `500` - Internal Server Error

## 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
paths:
  /api/v1/RecursosAdicionais/Cnpj/{cnpj}/Consultar:
    get:
      tags:
        - RecursosAdicionais
      summary: Consultar dados do CNPJ.
      description: >-
        Realiza a busca de informações cadastrais detalhadas de uma pessoa
        jurídica junto às bases de dados oficiais. 

        Este recurso é fundamental para a <strong>validação de
        emissores</strong> e garantia de que os dados cadastrais 

        estão atualizados para a correta aplicação das regras fiscais.


        ⚠️ **ATENÇÃO**: A consulta retorna dados públicos do registro da
        empresa. Certifique-se de que o CNPJ informado 

        esteje em formato válido para evitar erros de validação de máscara.


        🧪 **TESTE**: Em ambiente de sandbox, a consulta pode retornar dados
        simplificados ou simulados para garantir 

        a agilidade do desenvolvimento sem onerar bureaus de crédito ou bases
        governamentais reais.
      parameters:
        - name: cnpj
          in: path
          description: CNPJ a ser consultado.
          required: true
          schema:
            type: string
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ConsultaCnpjViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ConsultaCnpjViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ConsultaCnpjViewModel"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "404":
          description: Not Found
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "429":
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    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.
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
    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.
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```