# Busca CNPJ

> Parâmetros, exemplos e respostas de GET /v1/cnpj/{cnpj} na NextAPI.

Fonte: https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj

`GET /v1/cnpj/{cnpj}`

Pesquisa pelo CNPJ informado na base da Receita Federal e retorna os dados do estabelecimento comercial

Cada consulta consome 1 crédito.

> O custo de 1 crédito se aplica ao cache. Uma busca em tempo real pode consumir 15 créditos e exige permissão e saldo. Veja [como funciona toleranceDays](https://www.nextapi.com.br/docs/atualizacao-dos-dados.md).

URL base: `https://api.nextapi.com.br`. Autenticação: cabeçalho `Authorization: Bearer SEU_TOKEN`.

## Exemplo de requisição

```bash
curl --request GET 'https://api.nextapi.com.br/v1/cnpj/SEU_CNPJ' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Accept: application/json'
```

## Parâmetros

| Nome | Local | Obrigatório | Tipo / regras | Descrição |
| --- | --- | --- | --- | --- |
| `cnpj` | path | Sim | `string` | Número do CNPJ (somente dígitos, ex: 00000000000191) |
| `toleranceDays` | query | Não | `integer (int32)` | Quantidade máxima de dias de tolerância do cache (0 a 45) |

## Respostas HTTP

| Status | Descrição | Formato JSON |
| --- | --- | --- |
| `200` | Operação realizada com sucesso | CnpjItemResponse |
| `400` | Erro nos parametros informados na requisição | IErrorCodeModel |
| `404` | Registro não localizado | objeto |
| `405` | Falta de créditos para realizar a consulta | IErrorCodeModel |
| `500` | Erro ao processar a requisição | objeto |

Autenticação e limites também podem gerar erros antes da execução da operação. Veja o [guia de tratamento de erros](https://www.nextapi.com.br/docs/erros.md).

## Resposta de sucesso

Exemplo estrutural gerado do schema: os valores são ilustrativos. Campos anuláveis podem retornar `null`.

```json
{
  "cnpj": "string",
  "razaoSocial": "string",
  "nomeFantasia": "string",
  "tipo": "string",
  "dataAbertura": "string",
  "situacaoCadastral": "string",
  "dataSituacaoCadastral": "string",
  "motivoSituacaoCadastral": "string",
  "porte": "string",
  "capitalSocial": 0,
  "naturezaJuridica": "string",
  "logradouro": "string",
  "numero": "string",
  "complemento": "string",
  "cep": "string",
  "bairro": "string",
  "municipio": "string",
  "uf": "string",
  "email": "string",
  "telefone": "string",
  "situacaoEspecial": "string",
  "dataSituacaoEspecial": "string",
  "atividadePrincipal": {
    "codigo": "string",
    "descricao": "string"
  },
  "atividadeSecundaria": [
    {
      "codigo": "string",
      "descricao": "string"
    }
  ],
  "quadroDeSocios": [
    {
      "nome": "string",
      "qualificacao": "string",
      "representanteLegal": "string",
      "qualificacaoRepresentanteLegal": "string",
      "paisOrigem": "string"
    }
  ],
  "dataAtualizacao": "string"
}
```

## Campos da resposta

Modelo: `CnpjItemResponse`

### CnpjItemResponse

| Campo | Tipo | Obrigatório | Descrição / regras |
| --- | --- | --- | --- |
| `cnpj` | `string \| null` | Não marcado no contrato | — |
| `razaoSocial` | `string \| null` | Não marcado no contrato | — |
| `nomeFantasia` | `string \| null` | Não marcado no contrato | — |
| `tipo` | `string \| null` | Não marcado no contrato | — |
| `dataAbertura` | `string \| null` | Não marcado no contrato | — |
| `situacaoCadastral` | `string \| null` | Não marcado no contrato | — |
| `dataSituacaoCadastral` | `string \| null` | Não marcado no contrato | — |
| `motivoSituacaoCadastral` | `string \| null` | Não marcado no contrato | — |
| `porte` | `string \| null` | Não marcado no contrato | — |
| `capitalSocial` | `number (double) \| null` | Não marcado no contrato | — |
| `naturezaJuridica` | `string \| null` | Não marcado no contrato | — |
| `logradouro` | `string \| null` | Não marcado no contrato | — |
| `numero` | `string \| null` | Não marcado no contrato | — |
| `complemento` | `string \| null` | Não marcado no contrato | — |
| `cep` | `string \| null` | Não marcado no contrato | — |
| `bairro` | `string \| null` | Não marcado no contrato | — |
| `municipio` | `string \| null` | Não marcado no contrato | — |
| `uf` | `string \| null` | Não marcado no contrato | — |
| `email` | `string \| null` | Não marcado no contrato | — |
| `telefone` | `string \| null` | Não marcado no contrato | — |
| `situacaoEspecial` | `string \| null` | Não marcado no contrato | — |
| `dataSituacaoEspecial` | `string \| null` | Não marcado no contrato | — |
| `atividadePrincipal` | `CnpjItemResponseCode` | Não marcado no contrato | — |
| `atividadeSecundaria` | `CnpjItemResponseCode[]` | Não marcado no contrato | — |
| `quadroDeSocios` | `CnpjItemResponsePartner[]` | Não marcado no contrato | — |
| `dataAtualizacao` | `string \| null` | Não marcado no contrato | — |

### CnpjItemResponseCode

| Campo | Tipo | Obrigatório | Descrição / regras |
| --- | --- | --- | --- |
| `codigo` | `string \| null` | Não marcado no contrato | — |
| `descricao` | `string \| null` | Não marcado no contrato | — |

### CnpjItemResponsePartner

| Campo | Tipo | Obrigatório | Descrição / regras |
| --- | --- | --- | --- |
| `nome` | `string \| null` | Não marcado no contrato | — |
| `qualificacao` | `string \| null` | Não marcado no contrato | — |
| `representanteLegal` | `string \| null` | Não marcado no contrato | — |
| `qualificacaoRepresentanteLegal` | `string \| null` | Não marcado no contrato | — |
| `paisOrigem` | `string \| null` | Não marcado no contrato | — |