Consulta CNPJ API

https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/
Admin
Consulta CNPJ is a Brazilian government API that provides access to the National Registry of Legal...
Tokens:20,606
Snippets:50
Trust Score:10
Update:9 months ago
Show doc for...
Tokens:
Raw
### GET /api-cnpj-basica/v2/basica/{CNPJbasica}

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Retrieves basic information for a given CNPJ.

```APIDOC
## GET /api-cnpj-basica/v2/basica/{CNPJbasica}

### Description
Retrieves basic information for a given CNPJ.

### Method
GET

### Endpoint
/api-cnpj-basica/v2/basica/{CNPJbasica}

### Parameters
#### Path Parameters
- **CNPJbasica** (string) - Required - The CNPJ number for which to retrieve basic information.

#### Header Parameters
- **x-cpf-usuario** (string) - Required - CPF of the request user. Default: CPF do usuário da requisição CPF do usuário da requisição.

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **ni** (string) - Identification number.
- **tipoEstabelecimento** (string) - Type of establishment.
- **nomeEmpresarial** (string) - Business name.
- **nomeFantasia** (string) - Trade name.
- **situacaoCadastral** (object) - Cadastral situation details.
  - **codigo** (string) - Situation code.
  - **data** (string) - Date of situation.
  - **motivo** (string) - Reason for situation.
- **naturezaJuridica** (object) - Legal nature details.
  - **codigo** (string) - Legal nature code.
  - **descricao** (string) - Legal nature description.
- **dataAbertura** (string) - Opening date.
- **cnaePrincipal** (object) - Principal CNAE (National Classification of Economic Activities).
  - **codigo** (string) - CNAE code.
  - **descricao** (string) - CNAE description.
- **cnaeSecundarias** (array) - Array of secondary CNAE details.
  - **codigo** (string) - CNAE code.
  - **descricao** (string) - CNAE description.
- **endereco** (object) - Address details.
  - **tipoLogradouro** (string) - Type of street.
  - **logradouro** (string) - Street name.
  - **numero** (string) - House number.
  - **complemento** (string) - Complement.
  - **cep** (string) - Postal code.
  - **bairro** (string) - Neighborhood.
  - **municipio** (object) - Municipality details.
    - **codigo** (string) - Municipality code.
    - **descricao** (string) - Municipality description.
  - **pais** (object) - Country details.
    - **codigo** (string) - Country code.
    - **descricao** (string) - Country description.
- **municipioJurisdicao** (object) - Jurisdiction municipality details.
  - **codigo** (string) - Municipality code.
  - **descricao** (string) - Municipality description.
- **telefone** (array) - Array of phone numbers.
  - **ddd** (string) - Area code.
  - **numero** (string) - Phone number.
- **correioEletronico** (string) - Email address.
- **capitalSocial** (string) - Social capital.
- **porte** (string) - Company size.
- **situacaoEspecial** (string) - Special situation.
- **dataSituacaoEspecial** (string) - Date of special situation.
- **informacoesAdicionais** (object) - Additional information.
  - **optanteSimples** (string) - Option for Simple National regime.
  - **optanteMei** (string) - Option for MEI (Microempreendedor Individual) regime.
- **listaPeriodoSimples** (array) - List of Simple National periods.
  - **dataInicio** (string) - Start date.
  - **dataFim** (string) - End date.
- **socios** (array) - Array of partners/shareholders.
  - **tipoSocio** (string) - Type of partner.
  - **nome** (string) - Partner's name.
  - **qualificacao** (string) - Qualification.
  - **pais** (object) - Country details.
    - **codigo** (string) - Country code.
    - **descricao** (string) - Country description.
  - **representanteLegal** (object) - Legal representative details.
    - **nome** (string) - Representative's name.
    - **qualificacao** (string) - Representative's qualification.

#### Response Example
```json
{
  "ni": "string",
  "tipoEstabelecimento": "string",
  "nomeEmpresarial": "string",
  "nomeFantasia": "string",
  "situacaoCadastral": {
    "codigo": "string",
    "data": "string",
    "motivo": "string"
  },
  "naturezaJuridica": {
    "codigo": "string",
    "descricao": "string"
  },
  "dataAbertura": "string",
  "cnaePrincipal": {
    "codigo": "string",
    "descricao": "string"
  },
  "cnaeSecundarias": [
    {
      "codigo": "string",
      "descricao": "string"
    }
  ],
  "endereco": {
    "tipoLogradouro": "string",
    "logradouro": "string",
    "numero": "string",
    "complemento": "string",
    "cep": "string",
    "bairro": "string",
    "municipio": {
      "codigo": "string",
      "descricao": "string"
    },
    "pais": {
      "codigo": "string",
      "descricao": "string"
    }
  },
  "municipioJurisdicao": {
    "codigo": "string",
    "descricao": "string"
  },
  "telefone": [
    {
      "ddd": "string",
      "numero": "string"
    }
  ],
  "correioEletronico": "string",
  "capitalSocial": "string",
  "porte": "string",
  "situacaoEspecial": "string",
  "dataSituacaoEspecial": "string",
  "informacoesAdicionais": {
    "optanteSimples": "string",
    "optanteMei": "string"
  },
  "listaPeriodoSimples": [
    {
      "dataInicio": "string",
      "dataFim": "string"
    }
  ],
  "socios": [
    {
      "tipoSocio": "string",
      "nome": "string",
      "qualificacao": "string",
      "pais": {
        "codigo": "string",
        "descricao": "string"
      },
      "representanteLegal": {
        "nome": "string",
        "qualificacao": "string"
      }
    }
  ]
}
```
```

--------------------------------

### GET /api-cnpj-qsa/v2/qsa/{CNPJqsa}

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger

Consulta os dados dos Sócios (QSA) de um CNPJ específico. Retorna informações sobre os representantes legais e sócios da pessoa jurídica.

```APIDOC
## GET /api-cnpj-qsa/v2/qsa/{CNPJqsa}

### Description
Consulta os dados dos Sócios (QSA) de um CNPJ específico. Retorna informações sobre os representantes legais e sócios da pessoa jurídica.

### Method
GET

### Endpoint
/api-cnpj-qsa/v2/qsa/{CNPJqsa}

### Parameters
#### Path Parameters
- **CNPJqsa** (string) - Required - O número do CNPJ cujos sócios serão consultados.

#### Header Parameters
- **x-cpf-usuario** (string) - Required - CPF do usuário que está realizando a requisição.

### Request Example
```json
{
  "CNPJqsa": "12345678000199"
}
```

### Response
#### Success Response (200)
- **socios** (array) - Lista de sócios e representantes legais.
  - **tipoSocio** (string) - Tipo do sócio (Pessoa Física, Pessoa Jurídica).
  - **cpf** (string) - CPF do sócio (se Pessoa Física).
  - **nome** (string) - Nome do sócio ou razão social (se Pessoa Jurídica).
  - **dataInclusao** (string) - Data de inclusão do sócio na sociedade (formato YYYY-MM-DD).
  - **pais** (object) - Informações sobre o país de residência do sócio (se aplicável).
    - **codigo** (string) - Código do país.
    - **descricao** (string) - Nome do país.
  - **representanteLegal** (object) - Informações sobre o representante legal (se aplicável).
    - **cpf** (string) - CPF do representante legal.
    - **nome** (string) - Nome do representante legal.
    - **qualificacao** (string) - Código da qualificação do representante legal.

#### Response Example
```json
{
  "socios": [
    {
      "tipoSocio": "PESSOA FISICA",
      "cpf": "11111111111",
      "nome": "JOAO DA SILVA",
      "dataInclusao": "2010-01-15",
      "pais": {
        "codigo": "105",
        "descricao": "BRASIL"
      },
      "representanteLegal": {
        "cpf": "22222222222",
        "nome": "MARIA OLIVEIRA",
        "qualificacao": "05"
      }
    },
    {
      "tipoSocio": "PESSOA JURIDICA",
      "nome": "OUTRA EMPRESA LTDA",
      "dataInclusao": "2012-05-20",
      "pais": {
        "codigo": "105",
        "descricao": "BRASIL"
      }
    }
  ]
}
```

#### Error Responses
- **400 Bad Request**: O número de CNPJ informado não é válido.
- **401 Unauthorized**: Problemas durante a autenticação.
- **403 Forbidden**: Caminho incorreto na requisição.
- **404 Not Found**: Não existe CNPJ com o número de inscrição informado.
- **500 Internal Server Error**: Erro interno no servidor.
- **502 Bad Gateway**: Erro de integração com a API Consulta CNPJ.
- **504 Gateway Timeout**: Tempo esgotado do gateway.

**Observação**: Quando o CNPJ consultado for do tipo 'Empresário (Individual)', a API não retornará os campos referentes ao grupo de sócios (tipoSocio, cpf, nome, qualificacao, dataInclusao, pais, representanteLegal).
```

--------------------------------

### GET /api-cnpj-empresa/v2/empresa/{CNPJempresa}

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger

Consulta os dados de um CNPJ específico (Empresa). Retorna informações detalhadas sobre a pessoa jurídica.

```APIDOC
## GET /api-cnpj-empresa/v2/empresa/{CNPJempresa}

### Description
Consulta os dados de um CNPJ específico (Empresa). Retorna informações detalhadas sobre a pessoa jurídica.

### Method
GET

### Endpoint
/api-cnpj-empresa/v2/empresa/{CNPJempresa}

### Parameters
#### Path Parameters
- **CNPJempresa** (string) - Required - O número do CNPJ a ser consultado.

#### Header Parameters
- **x-cpf-usuario** (string) - Required - CPF do usuário que está realizando a requisição.

### Request Example
```json
{
  "CNPJempresa": "12345678000199"
}
```

### Response
#### Success Response (200)
- **razaoSocial** (string) - Razão social da empresa.
- **nomeFantasia** (string) - Nome fantasia da empresa.
- **cnpj** (string) - CNPJ da empresa.
- **dataAbertura** (string) - Data de abertura da empresa (formato YYYY-MM-DD).
- **tipo** (string) - Tipo da empresa (Pessoa Jurídica).
- **situacao** (string) - Situação cadastral da empresa.
- **motivoSituacao** (string) - Motivo da situação cadastral.
- **dataSituacao** (string) - Data da alteração da situação cadastral (formato YYYY-MM-DD).
- **complemento** (string) - Complemento do endereço.
- **logradouro** (string) - Logradouro do endereço.
- **numero** (string) - Número do endereço.
- **bairro** (string) - Bairro do endereço.
- **cep** (string) - CEP do endereço.
- **uf** (string) - Unidade federativa (estado).
- **municipio** (object) - Informações sobre o município.
  - **codigo** (string) - Código do município.
  - **descricao** (string) - Nome do município.
- **pais** (object) - Informações sobre o país.
  - **codigo** (string) - Código do país.
  - **descricao** (string) - Nome do país.
- **naturezaJuridica** (object) - Informações sobre a natureza jurídica.
  - **codigo** (string) - Código da natureza jurídica.
  - **descricao** (string) - Descrição da natureza jurídica.
- **capitalSocial** (number) - Valor do capital social.
- **cnaes** (array) - Lista de atividades econômicas (CNAEs).
  - **codigo** (string) - Código do CNAE.
  - **descricao** (string) - Descrição do CNAE.
  - **principal** (boolean) - Indica se é o CNAE principal.
- **email** (string) - Endereço de e-mail da empresa.
- **telefone** (string) - Número de telefone da empresa.
- **enteFederativo** (string) - Indica se é um ente federativo.
- **strAtividadePrincipal** (string) - Descrição da atividade principal.

#### Response Example
```json
{
  "razaoSocial": "NOME DA EMPRESA LTDA",
  "nomeFantasia": "EMPRESA EXEMPLO",
  "cnpj": "12345678000199",
  "dataAbertura": "2010-01-15",
  "tipo": "PESSOA JURIDICA",
  "situacao": "ATIVO",
  "motivoSituacao": "",
  "dataSituacao": "2010-01-15",
  "complemento": "SALA 101",
  "logradouro": "RUA DAS EXEMPLOS",
  "numero": "123",
  "bairro": "CENTRO",
  "cep": "12345-678",
  "uf": "SP",
  "municipio": {
    "codigo": "3550308",
    "descricao": "SAO PAULO"
  },
  "pais": {
    "codigo": "105",
    "descricao": "BRASIL"
  },
  "naturezaJuridica": {
    "codigo": "2062",
    "descricao": "SOCIEDADE EMPRESARIA LIMITADA"
  },
  "capitalSocial": 10000.00,
  "cnaes": [
    {
      "codigo": "6204000",
      "descricao": "Consultoria em tecnologia da informação",
      "principal": true
    }
  ],
  "email": "contato@empresaexemplo.com.br",
  "telefone": "(11) 1234-5678",
  "enteFederativo": "",
  "strAtividadePrincipal": "Consultoria em tecnologia da informação"
}
```

#### Error Responses
- **400 Bad Request**: O número de CNPJ informado não é válido.
- **401 Unauthorized**: Problemas durante a autenticação.
- **403 Forbidden**: Caminho incorreto na requisição.
- **404 Not Found**: Não existe CNPJ com o número de inscrição informado.
- **500 Internal Server Error**: Erro interno no servidor.
- **502 Bad Gateway**: Erro de integração com a API Consulta CNPJ.
- **504 Gateway Timeout**: Tempo esgotado do gateway.
```

--------------------------------

### GET /websites/gov_br_conecta_catalogo_apis_consulta-cnpj/api/v1/qsa/{CNPJqsa}

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger

Retrieves the "Quadro de Sócios e Administradores" (QSA) information for a given CNPJ.

```APIDOC
## GET /websites/gov_br_conecta_catalogo_apis_consulta-cnpj/api/v1/qsa/{CNPJqsa}

### Description
Retrieves the "Quadro de Sócios e Administradores" (QSA) information for a given CNPJ.

### Method
GET

### Endpoint
/websites/gov_br_conecta_catalogo_apis_consulta-cnpj/api/v1/qsa/{CNPJqsa}

### Parameters
#### Path Parameters
- **CNPJqsa** (string) - Required - The CNPJ number to query.

#### Header Parameters
- **x-cpf-usuario** (string) - Required - CPF of the request user.

### Response
#### Success Response (200)
- **ni** (string) - National Identifier.
- **tipoEstabelecimento** (string) - Establishment type.
- **nomeEmpresarial** (string) - Business name.
- **nomeFantasia** (string) - Trade name.
- **situacaoCadastral** (object) - Registration status.
  - **codigo** (string) - Status code.
  - **data** (string) - Status date.

#### Error Responses
- **400**: Bad Request - Invalid CNPJ format.
- **401**: Unauthorized - Authentication issues.
- **403**: Forbidden - Incorrect API path.
- **404**: Not Found - CNPJ does not exist.
- **500**: Internal Server Error - Server-side error.
- **502**: Integration Error - Error during API integration.
- **504**: Gateway Timeout - Network error.
```

--------------------------------

### GET /api-cnpj-empresa/v2/empresa/{CNPJempresa}

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Retrieves detailed information about a company (Empresa) using its CNPJ.

```APIDOC
## GET /api-cnpj-empresa/v2/empresa/{CNPJempresa}

### Description
Retrieves detailed information about a company (Empresa) using its CNPJ.

### Method
GET

### Endpoint
`/api-cnpj-empresa/v2/empresa/{CNPJempresa}`

### Parameters
#### Path Parameters
- **CNPJempresa** (string) - Required - The CNPJ of the company to query.

#### Header Parameters
- **x-cpf-usuario** (string) - Required - The CPF of the user making the request.

### Request Example
```json
{
  "CNPJempresa": "12345678000101"
}
```

### Response
#### Success Response (200)
- **ni** (string) - National Identification number.
- **tipoEstabelecimento** (string) - Type of establishment.
- **nomeEmpresarial** (string) - Company's legal name.
- **nomeFantasia** (string) - Company's trade name.
- **situacaoCadastral** (object) - Company's registration status.
  - **codigo** (string) - Status code.
  - **data** (string) - Date of status change.
  - **motivo** (string) - Reason for status change.
- **naturezaJuridica** (object) - Legal nature of the company.
  - **codigo** (string) - Legal nature code.
  - **descricao** (string) - Legal nature description.
- **dataAbertura** (string) - Company opening date.
- **cnaePrincipal** (object) - Primary CNAE (National Classification of Economic Activities).
  - **codigo** (string) - CNAE code.
  - **descricao** (string) - CNAE description.
- **cnaeSecundarias** (array) - Secondary CNAEs.
  - **codigo** (string) - CNAE code.
  - **descricao** (string) - CNAE description.
- **endereco** (object) - Company address.
  - **tipoLogradouro** (string) - Type of street.
  - **logradouro** (string) - Street name.
  - **numero** (string) - Street number.
  - **complemento** (string) - Complementary address information.
  - **cep** (string) - Postal code.
  - **bairro** (string) - Neighborhood.
  - **municipio** (object) - Municipality.
    - **codigo** (string) - Municipality code.
    - **descricao** (string) - Municipality name.
  - **pais** (object) - Country.
    - **codigo** (string) - Country code.
    - **descricao** (string) - Country name.
- **municipioJurisdicao** (object) - Jurisdiction municipality.
  - **codigo** (string) - Municipality code.
  - **descricao** (string) - Municipality name.
- **telefone** (array) - Phone numbers.
  - **ddd** (string) - Area code.
  - **numero** (string) - Phone number.
- **correioEletronico** (string) - Email address.
- **capitalSocial** (string) - Social capital.
- **porte** (string) - Company size.
- **situacaoEspecial** (string) - Special situation.
- **dataSituacaoEspecial** (string) - Date of special situation.
- **informacoesAdicionais** (object) - Additional information.
  - **optanteSimples** (string) - Indicates if opted for Simples Nacional.
  - **optanteMei** (string) - Indicates if opted for MEI.
- **listaPeriodoSimples** (array) - List of Simples Nacional periods.
  - **dataInicio** (string) - Start date.
  - **dataFim** (string) - End date.
- **socios** (array) - Partners/Shareholders.
  - **tipoSocio** (string) - Type of partner.
  - **cpf** (string) - Partner's CPF.
  - **nome** (string) - Partner's name.
  - **qualificacao** (string) - Partner's qualification.
  - **dataInclusao** (string) - Date of inclusion.
  - **pais** (object) - Partner's country.
    - **codigo** (string) - Country code.
    - **descricao** (string) - Country name.
  - **representanteLegal** (object) - Legal representative of the partner.
    - **cpf** (string) - Representative's CPF.
    - **nome** (string) - Representative's name.
    - **qualificacao** (string) - Representative's qualification.

#### Response Example (200)
```json
{
  "ni": "string",
  "tipoEstabelecimento": "string",
  "nomeEmpresarial": "string",
  "nomeFantasia": "string",
  "situacaoCadastral": {
    "codigo": "string",
    "data": "string",
    "motivo": "string"
  },
  "naturezaJuridica": {
    "codigo": "string",
    "descricao": "string"
  },
  "dataAbertura": "string",
  "cnaePrincipal": {
    "codigo": "string",
    "descricao": "string"
  },
  "cnaeSecundarias": [
    {
      "codigo": "string",
      "descricao": "string"
    }
  ],
  "endereco": {
    "tipoLogradouro": "string",
    "logradouro": "string",
    "numero": "string",
    "complemento": "string",
    "cep": "string",
    "bairro": "string",
    "municipio": {
      "codigo": "string",
      "descricao": "string"
    },
    "pais": {
      "codigo": "string",
      "descricao": "string"
    }
  },
  "municipioJurisdicao": {
    "codigo": "string",
    "descricao": "string"
  },
  "telefone": [
    {
      "ddd": "string",
      "numero": "string"
    }
  ],
  "correioEletronico": "string",
  "capitalSocial": "string",
  "porte": "string",
  "situacaoEspecial": "string",
  "dataSituacaoEspecial": "string",
  "informacoesAdicionais": {
    "optanteSimples": "string",
    "optanteMei": "string"
  },
  "listaPeriodoSimples": [
    {
      "dataInicio": "string",
      "dataFim": "string"
    }
  ],
  "socios": [
    {
      "tipoSocio": "string",
      "cpf": "string",
      "nome": "string",
      "qualificacao": "string",
      "dataInclusao": "string",
      "pais": {
        "codigo": "string",
        "descricao": "string"
      },
      "representanteLegal": {
        "cpf": "string",
        "nome": "string",
        "qualificacao": "string"
      }
    }
  ]
}
```

#### Error Responses
- **400** - Requisição inválida - The CNPJ number provided is invalid.
- **401** - Não autorizado - Authentication failed.
- **403** - Proibido - Incorrect API path.
- **404** - Não Encontrado - CNPJ not found.
- **500** - Erro no servidor - Internal server error.
- **502** - Erro de integração - Integration error.
- **504** - Tempo Esgotado do Gateway - Gateway timeout.
```

--------------------------------

### GET /api-cnpj-qsa/v2/qsa/{CNPJqsa}

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Retrieves QSA (Quadro de Sócios e Administradores) data associated with a given CNPJ.

```APIDOC
## GET /api-cnpj-qsa/v2/qsa/{CNPJqsa}

### Description
Retrieves the QSA (Quadro de Sócios e Administradores) information for a given CNPJ.

### Method
GET

### Endpoint
/api-cnpj-qsa/v2/qsa/{CNPJqsa}

### Parameters
#### Path Parameters
- **CNPJqsa** (string) - Required - The CNPJ number for which to retrieve QSA data.

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **ni** (string) - Identification number.
- **tipoEstabelecimento** (string) - Type of establishment.
- **nomeEmpresarial** (string) - Business name.
- **nomeFantasia** (string) - Trade name.
- **situacaoCadastral** (object) - Cadastral situation details.
  - **codigo** (string) - Situation code.
  - **data** (string) - Date of situation.
  - **motivo** (string) - Reason for situation.
- **naturezaJuridica** (object) - Legal nature details.
  - **codigo** (string) - Legal nature code.
  - **descricao** (string) - Legal nature description.
- **dataAbertura** (string) - Opening date.
- **cnaePrincipal** (object) - Principal CNAE (National Classification of Economic Activities).
  - **codigo** (string) - CNAE code.
  - **descricao** (string) - CNAE description.
- **cnaeSecundarias** (array) - Array of secondary CNAE details.
  - **codigo** (string) - CNAE code.
  - **descricao** (string) - CNAE description.
- **endereco** (object) - Address details.
  - **tipoLogradouro** (string) - Type of street.
  - **logradouro** (string) - Street name.
  - **numero** (string) - House number.
  - **complemento** (string) - Complement.
  - **cep** (string) - Postal code.
  - **bairro** (string) - Neighborhood.
  - **municipio** (object) - Municipality details.
    - **codigo** (string) - Municipality code.
    - **descricao** (string) - Municipality description.
  - **pais** (object) - Country details.
    - **codigo** (string) - Country code.
    - **descricao** (string) - Country description.
- **municipioJurisdicao** (object) - Jurisdiction municipality details.
  - **codigo** (string) - Municipality code.
  - **descricao** (string) - Municipality description.
- **telefone** (array) - Array of phone numbers.
  - **ddd** (string) - Area code.
  - **numero** (string) - Phone number.
- **correioEletronico** (string) - Email address.
- **capitalSocial** (string) - Social capital.
- **porte** (string) - Company size.
- **situacaoEspecial** (string) - Special situation.
- **dataSituacaoEspecial** (string) - Date of special situation.
- **informacoesAdicionais** (object) - Additional information.
  - **optanteSimples** (string) - Option for Simple National regime.
  - **optanteMei** (string) - Option for MEI (Microempreendedor Individual) regime.
- **listaPeriodoSimples** (array) - List of Simple National periods.
  - **dataInicio** (string) - Start date.
  - **dataFim** (string) - End date.
- **socios** (array) - Array of partners/shareholders.
  - **tipoSocio** (string) - Type of partner.
  - **nome** (string) - Partner's name.
  - **qualificacao** (string) - Qualification.
  - **pais** (object) - Country details.
    - **codigo** (string) - Country code.
    - **descricao** (string) - Country description.
  - **representanteLegal** (object) - Legal representative details.
    - **nome** (string) - Representative's name.
    - **qualificacao** (string) - Representative's qualification.

#### Response Example
```json
{
  "ni": "string",
  "tipoEstabelecimento": "string",
  "nomeEmpresarial": "string",
  "nomeFantasia": "string",
  "situacaoCadastral": {
    "codigo": "string",
    "data": "string",
    "motivo": "string"
  },
  "naturezaJuridica": {
    "codigo": "string",
    "descricao": "string"
  },
  "dataAbertura": "string",
  "cnaePrincipal": {
    "codigo": "string",
    "descricao": "string"
  },
  "cnaeSecundarias": [
    {
      "codigo": "string",
      "descricao": "string"
    }
  ],
  "endereco": {
    "tipoLogradouro": "string",
    "logradouro": "string",
    "numero": "string",
    "complemento": "string",
    "cep": "string",
    "bairro": "string",
    "municipio": {
      "codigo": "string",
      "descricao": "string"
    },
    "pais": {
      "codigo": "string",
      "descricao": "string"
    }
  },
  "municipioJurisdicao": {
    "codigo": "string",
    "descricao": "string"
  },
  "telefone": [
    {
      "ddd": "string",
      "numero": "string"
    }
  ],
  "correioEletronico": "string",
  "capitalSocial": "string",
  "porte": "string",
  "situacaoEspecial": "string",
  "dataSituacaoEspecial": "string",
  "informacoesAdicionais": {
    "optanteSimples": "string",
    "optanteMei": "string"
  },
  "listaPeriodoSimples": [
    {
      "dataInicio": "string",
      "dataFim": "string"
    }
  ],
  "socios": [
    {
      "tipoSocio": "string",
      "nome": "string",
      "qualificacao": "string",
      "pais": {
        "codigo": "string",
        "descricao": "string"
      },
      "representanteLegal": {
        "nome": "string",
        "qualificacao": "string"
      }
    }
  ]
}
```
```

--------------------------------

### Authentication

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Endpoint para obtenção de Access Token, necessário para autenticar as requisições à API.

```APIDOC
## POST /oauth2/jwt-token

### Description
Endpoint para obter um Access Token JWT.

### Method
POST

### Endpoint
*   **Produção:** `https://apigateway.conectagov.estaleiro.serpro.gov.br/oauth2/jwt-token`
*   **Homologação:** `https://h-apigateway.conectagov.np.estaleiro.serpro.gov.br/oauth2/jwt-token`

### Parameters
#### Request Body
*   **grant_type** (string) - Required - Deve ser "client_credentials".
*   **client_id** (string) - Required - O ID do cliente fornecido.
*   **client_secret** (string) - Required - O segredo do cliente fornecido.

### Request Example
```json
{
  "grant_type": "client_credentials",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
```

### Response
#### Success Response (200)
- **access_token** (string) - O token de acesso JWT.
- **token_type** (string) - O tipo do token (geralmente "Bearer").
- **expires_in** (integer) - O tempo de expiração do token em segundos.

#### Response Example
```json
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}
```
```

--------------------------------

### Consulta Básica CNPJ

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Endpoint para obter dados básicos de um CNPJ. Retorna informações essenciais sobre a empresa.

```APIDOC
## GET /api-cnpj-basica/v2/basica/

### Description
Consulta os dados básicos de um CNPJ (Empresa).

### Method
GET

### Endpoint
`https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-basica/v2/basica/`

### Parameters
#### Query Parameters
- **cnpj** (string) - Required - O número do CNPJ a ser consultado.

### Request Example
```json
{
  "cnpj": "00000000000000"
}
```

### Response
#### Success Response (200)
- **ni** (string) - Número de Inscrição da Pessoa Jurídica.
- **tipoEstabelecimento** (string) - Tipo de estabelecimento: 1: Matriz, 2: Filial.
- **nomeEmpresarial** (string) - Nome empresarial da Pessoa Jurídica.
- **nomefantasia** (string) - Nome fantasia da Pessoa Jurídica.
- **situacaoCadastral** (structure) - Situação Cadastral da Pessoa Jurídica.
- **naturezaJuridica** (structure) - Informação da Natureza Jurídica da Pessoa Jurídica.
- **dataAbertura** (string) - AAAAMMDD - Data de abertura do estabelecimento.
- **cnaePrincipal** (structure) - Informação da Classificação Nacional de Atividades Econômicas.
- **endereco** (structure) - Endereço da Pessoa Jurídica.
- **municipioJurisdicao** (structure) - Município de Jurisdição do endereço.
- **telefone** (structure) - Números de telefone da Pessoa Jurídica.
- **correioEletronico** (string) - Correio eletrônico da Pessoa Jurídica.
- **capitalSocial** (string) - Capital social da Pessoa Jurídica.
- **porteEmpresa** (string) - Porte da Pessoa Jurídica: 01: MicroEmpresa-ME, 03: Empresas de pequeno porte EPP, 05: Demais empresas.

#### Response Example
```json
{
  "ni": "12345678901234",
  "tipoEstabelecimento": "1",
  "nomeEmpresarial": "EMPRESA EXEMPLO LTDA",
  "nomefantasia": "EXEMPLO",
  "situacaoCadastral": {},
  "naturezaJuridica": {},
  "dataAbertura": "20000101",
  "cnaePrincipal": {},
  "endereco": {},
  "municipioJurisdicao": {},
  "telefone": [],
  "correioEletronico": "contato@exemplo.com",
  "capitalSocial": "100000",
  "porteEmpresa": "05"
}
```
```

--------------------------------

### Consulta CNPJ-QSA

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Endpoint para obter dados do Quadro de Sócios e Administradores (QSA) de um CNPJ. Retorna informações sobre os sócios e administradores da empresa.

```APIDOC
## GET /api-cnpj-qsa/v2/qsa/

### Description
Consulta os dados de um CNPJ (QSA - Quadro de Sócios e Administradores).

### Method
GET

### Endpoint
`https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-qsa/v2/qsa/`

### Parameters
#### Query Parameters
- **cnpj** (string) - Required - O número do CNPJ a ser consultado.

### Request Example
```json
{
  "cnpj": "00000000000000"
}
```

### Response
#### Success Response (200)
- **ni** (string) - Número de Inscrição da Pessoa Jurídica.
- **tipoEstabelecimento** (string) - Tipo de estabelecimento: 1: Matriz, 2: Filial.
- **nomeEmpresarial** (string) - Nome empresarial da Pessoa Jurídica.
- **nomefantasia** (string) - Nome fantasia da Pessoa Jurídica.
- **situacaoCadastral** (structure) - Situação Cadastral da Pessoa Jurídica.
- **naturezaJuridica** (structure) - Informação da Natureza Jurídica da Pessoa Jurídica.
- **dataAbertura** (string) - AAAAMMDD - Data de abertura do estabelecimento.
- **cnaePrincipal** (structure) - Informação da Classificação Nacional de Atividades Econômicas.
- **endereco** (structure) - Endereço da Pessoa Jurídica.
- **municipioJurisdicao** (structure) - Município de Jurisdição do endereço.
- **telefone** (structure) - Números de telefone da Pessoa Jurídica.
- **correioEletronico** (string) - Correio eletrônico da Pessoa Jurídica.
- **capitalSocial** (string) - Capital social da Pessoa Jurídica.
- **porteEmpresa** (string) - Porte da Pessoa Jurídica: 01: MicroEmpresa-ME, 03: Empresas de pequeno porte EPP, 05: Demais empresas.
- **informacoesAdicionais** (structure) - Informações Referentes a MEI e optante pelo SIMPLES.
- **listaPeriodosSimples** (structure) - Períodos em que a empresa optou pelo SIMPLES.
- **socios** (structure) - Sócios da Pessoa Jurídica.

#### Response Example
```json
{
  "ni": "12345678901234",
  "tipoEstabelecimento": "1",
  "nomeEmpresarial": "EMPRESA EXEMPLO LTDA",
  "nomefantasia": "EXEMPLO",
  "situacaoCadastral": {},
  "naturezaJuridica": {},
  "dataAbertura": "20000101",
  "cnaePrincipal": {},
  "endereco": {},
  "municipioJurisdicao": {},
  "telefone": [],
  "correioEletronico": "contato@exemplo.com",
  "capitalSocial": "100000",
  "porteEmpresa": "05",
  "informacoesAdicionais": {},
  "listaPeriodosSimples": [],
  "socios": []
}
```
```

--------------------------------

### Consulta CNPJ-Empresa

Source: https://www.gov.br/conecta/catalogo/apis/consulta-cnpj/swagger.json/swagger_view

Endpoint para obter informações detalhadas sobre uma empresa CNPJ. Retorna todos os campos disponíveis.

```APIDOC
## GET /api-cnpj-empresa/v2/empresa/

### Description
Consulta os dados de um CNPJ (Empresa) - Informações detalhadas sobre a empresa.

### Method
GET

### Endpoint
`https://apigateway.conectagov.estaleiro.serpro.gov.br/api-cnpj-empresa/v2/empresa/`

### Parameters
#### Query Parameters
- **cnpj** (string) - Required - O número do CNPJ a ser consultado.

### Request Example
```json
{
  "cnpj": "00000000000000"
}
```

### Response
#### Success Response (200)
- **ni** (string) - Número de Inscrição da Pessoa Jurídica.
- **tipoEstabelecimento** (string) - Tipo de estabelecimento: 1: Matriz, 2: Filial.
- **nomeEmpresarial** (string) - Nome empresarial da Pessoa Jurídica.
- **nomefantasia** (string) - Nome fantasia da Pessoa Jurídica.
- **situacaoCadastral** (structure) - Situação Cadastral da Pessoa Jurídica.
- **naturezaJuridica** (structure) - Informação da Natureza Jurídica da Pessoa Jurídica.
- **dataAbertura** (string) - AAAAMMDD - Data de abertura do estabelecimento.
- **cnaePrincipal** (structure) - Informação da Classificação Nacional de Atividades Econômicas.
- **cnaeSecundarias** (structure) - Informação da Classificação Nacional de Atividades Econômicas: - Várias ocorrências.
- **endereco** (structure) - Endereço da Pessoa Jurídica.
- **municipioJurisdicao** (structure) - Município de Jurisdição do endereço.
- **telefone** (structure) - Números de telefone da Pessoa Jurídica - Várias ocorrências.
- **correioEletronico** (string) - Correio eletrônico da Pessoa Jurídica.
- **capitalSocial** (string) - Capital social da Pessoa Jurídica.
- **porteEmpresa** (string) - Porte da Pessoa Jurídica: 01: MicroEmpresa-ME, 03: Empresas de pequeno porte EPP, 05: Demais empresas.
- **situacaoEspecial** (string) - Tipos de Situação Especial da Pessoa Jurídica.
- **dataSituacaoEspecial** (string) - Data em que a empresa entrou na Situação Especial.
- **informacoesAdicionais** (structure) - Informações Referentes a MEI e optante pelo SIMPLES.
- **listaPeriodosSimples** (structure) - Períodos em que a empresa optou pelo SIMPLES - Várias ocorrências.
- **socios** (structure) - Sócios da Pessoa Jurídica - Várias ocorrências.
- **representanteLegal** (structure) - Representante legal da Pessoa Jurídica.
- **municipio** (structure) - Informações sobre o município da empresa.
- **pais** (structure) - Informações sobre o país da empresa.

#### Response Example
```json
{
  "ni": "12345678901234",
  "tipoEstabelecimento": "1",
  "nomeEmpresarial": "EMPRESA EXEMPLO LTDA",
  "nomefantasia": "EXEMPLO",
  "situacaoCadastral": {},
  "naturezaJuridica": {},
  "dataAbertura": "20000101",
  "cnaePrincipal": {},
  "cnaeSecundarias": [],
  "endereco": {},
  "municipioJurisdicao": {},
  "telefone": [],
  "correioEletronico": "contato@exemplo.com",
  "capitalSocial": "100000",
  "porteEmpresa": "05",
  "situacaoEspecial": "",
  "dataSituacaoEspecial": "",
  "informacoesAdicionais": {},
  "listaPeriodosSimples": [],
  "socios": [],
  "representanteLegal": {},
  "municipio": {},
  "pais": {}
}
```
```
Tokens:
Raw