---
updatedAt: 2026-06-08T12:15:24.000Z
agentTools:
  projectIndex: https://doc.focusnfe.com.br/llms.txt
---

# Consultar

Consulta cadastro de uma empresa pelo número de inscrição no CNPJ (14 dígitos).

Informe apenas números, sem pontuação. Exemplo: 12345678000123.


# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "CNPJ",
    "version": "2.0.0",
    "contact": {
      "name": "Focus NFe Suporte",
      "email": "suporte@focusnfe.com.br"
    },
    "license": {
      "name": "Proprietary",
      "url": "https://focusnfe.com.br"
    }
  },
  "servers": [
    {
      "url": "https://api.focusnfe.com.br/v2",
      "description": "Servidor de Produção"
    },
    {
      "url": "https://homologacao.focusnfe.com.br/v2",
      "description": "Servidor de Homologação"
    }
  ],
  "security": [
    {
      "BasicAuth": []
    }
  ],
  "tags": [
    {
      "name": "CNPJ",
      "description": "Operações relacionadas à consulta de CNPJ"
    }
  ],
  "paths": {
    "/cnpjs/{cnpj}": {
      "get": {
        "tags": [
          "CNPJ"
        ],
        "summary": "Consultar",
        "description": "Consulta cadastro de uma empresa pelo número de inscrição no CNPJ (14 dígitos).\n\nInforme apenas números, sem pontuação. Exemplo: 12345678000123.\n",
        "operationId": "consultar_cnpj",
        "parameters": [
          {
            "name": "cnpj",
            "in": "path",
            "required": true,
            "description": "Número de inscrição no CNPJ com 14 dígitos (somente números).",
            "schema": {
              "type": "string",
              "pattern": "^[0-9]{14}$",
              "example": "12345678000123"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Requisição processada com sucesso",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CnpjResponse"
                },
                "example": {
                  "razao_social": "EMPRESA EXEMPLO LTDA",
                  "cnpj": "12345678000123",
                  "situacao_cadastral": "ativa",
                  "cnae_principal": "0000000",
                  "optante_simples_nacional": false,
                  "optante_mei": false,
                  "endereco": {
                    "codigo_municipio": "0000",
                    "codigo_siafi": "0000",
                    "codigo_ibge": "0000000",
                    "nome_municipio": "CIDADE EXEMPLO",
                    "tipo_logradouro": "RUA",
                    "logradouro": "EXEMPLO",
                    "complemento": "Sala 100",
                    "numero": "100",
                    "bairro": "BAIRRO EXEMPLO",
                    "cep": "00000000",
                    "uf": "XX"
                  }
                }
              }
            }
          },
          "400": {
            "description": "Requisição inválida",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "example": {
                  "codigo": "requisicao_invalida",
                  "mensagem": "Requisição mal formada."
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/AccessDenied"
          },
          "404": {
            "$ref": "#/components/responses/CnpjNaoEncontrado"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "BasicAuth": {
        "type": "http",
        "scheme": "basic",
        "description": "Autenticação com usuário e senha (HTTP Basic). O usuário é o token da API e a senha deve ser deixada em branco."
      }
    },
    "responses": {
      "AccessDenied": {
        "description": "Não autorizado",
        "content": {
          "text/html": {
            "schema": {
              "type": "string"
            },
            "example": "HTTP Basic: Access denied"
          }
        }
      },
      "CnpjNaoEncontrado": {
        "description": "Recurso não encontrado",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "example": {
              "codigo": "nao_encontrado",
              "mensagem": "Dados do CNPJ 12345678000123 não encontrados."
            }
          }
        }
      }
    },
    "schemas": {
      "CnpjResponse": {
        "title": "CNPJ",
        "type": "object",
        "properties": {
          "razao_social": {
            "type": "string",
            "description": "Razão Social da empresa."
          },
          "cnpj": {
            "type": "string",
            "description": "Número de inscrição no CNPJ (14 dígitos)."
          },
          "situacao_cadastral": {
            "type": "string",
            "description": "Situação cadastral da empresa."
          },
          "cnae_principal": {
            "type": "string",
            "description": "CNAE Principal."
          },
          "optante_simples_nacional": {
            "type": "boolean",
            "description": "Indica se a empresa é optante pelo Simples Nacional."
          },
          "optante_mei": {
            "type": "boolean",
            "description": "Indica se a empresa é optante pelo MEI."
          },
          "endereco": {
            "$ref": "#/components/schemas/EnderecoCnpj"
          }
        }
      },
      "EnderecoCnpj": {
        "title": "Endereço",
        "type": "object",
        "properties": {
          "codigo_municipio": {
            "type": "string",
            "description": "Código SIAFI do município. Em breve representará o código IBGE."
          },
          "codigo_siafi": {
            "type": "string",
            "description": "Código SIAFI do município onde a empresa está registrada."
          },
          "codigo_ibge": {
            "type": "string",
            "description": "Código IBGE do município onde a empresa está registrada."
          },
          "nome_municipio": {
            "type": "string",
            "description": "Nome do município."
          },
          "tipo_logradouro": {
            "type": "string",
            "description": "Tipo do logradouro (por exemplo, Rua, Avenida)."
          },
          "logradouro": {
            "type": "string",
            "description": "Nome do logradouro."
          },
          "complemento": {
            "type": "string",
            "description": "Complemento do endereço, se houver."
          },
          "numero": {
            "type": "string",
            "description": "Número do logradouro, se houver."
          },
          "bairro": {
            "type": "string",
            "description": "Bairro."
          },
          "cep": {
            "type": "string",
            "description": "CEP."
          },
          "uf": {
            "type": "string",
            "description": "UF."
          }
        }
      },
      "ErrorResponse": {
        "title": "Erro",
        "type": "object",
        "properties": {
          "codigo": {
            "type": "string",
            "description": "Código do erro"
          },
          "mensagem": {
            "type": "string",
            "description": "Mensagem descritiva do erro"
          },
          "correcao": {
            "type": "string",
            "description": "Correção do erro"
          }
        }
      }
    }
  }
}
```