Busca 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.

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

Exemplo de requisição

Substitua os valores de exemplo pelos dados da sua consulta. O código não executa uma chamada automaticamente.

cURL

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

Envie Accept: application/json para solicitar JSON. Autenticação e limites também podem gerar erros antes da execução da operação. Consulte o guia de tratamento de erros.

Resposta de sucesso

Exemplo estrutural gerado do schema: os valores abaixo são ilustrativos, não representam uma consulta real. Campos anuláveis podem retornar null.

JSON · estrutura ilustrativa

{
  "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	—

Contrato desta operação

OpenAPI · JSON

{
  "tags": [
    "CNPJ"
  ],
  "summary": "Busca CNPJ",
  "description": "Pesquisa pelo CNPJ informado na base da Receita Federal e retorna os dados do estabelecimento comercial\n\nCada consulta consome 1 crédito.",
  "parameters": [
    {
      "name": "cnpj",
      "in": "path",
      "description": "Número do CNPJ (somente dígitos, ex: 00000000000191)",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "toleranceDays",
      "in": "query",
      "description": "Quantidade máxima de dias de tolerância do cache (0 a 45)",
      "schema": {
        "type": "integer",
        "format": "int32"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Operação realizada com sucesso",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CnpjItemResponse"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/CnpjItemResponse"
          }
        }
      }
    },
    "400": {
      "description": "Erro nos parametros informados na requisição",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "404": {
      "description": "Registro não localizado",
      "content": {
        "application/json": {
          "schema": {}
        },
        "text/xml": {
          "schema": {}
        }
      }
    },
    "405": {
      "description": "Falta de créditos para realizar a consulta",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "500": {
      "description": "Erro ao processar a requisição",
      "content": {
        "application/json": {
          "schema": {}
        },
        "text/xml": {
          "schema": {}
        }
      }
    }
  },
  "method": "GET",
  "path": "/v1/cnpj/{cnpj}",
  "slug": "get-v1-cnpj-cnpj"
}