# Consultar CNPJ com PHP

O PHP é uma das linguagem mais utilizadas no desenvolvimento web e com ela é muito simples fazer uma consulta na API do [CNPJ.ws](https://www.cnpj.ws).

Com a integração podemos usar a API para consultar o endereço, inscrição estadual, situação cadastral, CNAE e muitas outras informações que podem ser importantes no momento do cadastro do cliente ou fornecedor através do CNPJ.

### API Pública

O [CNPJ.ws](https://www.cnpj.ws) disponibiliza uma API pública para consultas onde você pode fazer até 3 consultas por minuto. [Veja a documentação](https://docs.cnpj.ws/referencia-de-api/api-publica/consultando-cnpj).

```php
<?php

$url = "https://publica.cnpj.ws/cnpj/27865757000102";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
```

### API Comercial

Na API comercial você não possui um limite de requisições por minuto mas há um limite de consultas mensais conforme o plano contratado, [veja nossos planos](https://www.cnpj.ws).

[Veja a documentação da API Comercial](https://docs.cnpj.ws/referencia-de-api/api-comercial/consultando-cnpj)

```php
<?php

$url = "https://comercial.cnpj.ws/cnpj/27865757000102";

$curl = curl_init($url);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

$headers = array(
   "x_api_token: SEU_TOKEN",
);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
//for debug only!
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($curl);
curl_close($curl);
var_dump($resp);
```

### Exemplo de Retorno

Abaixo um exemplo de retorno da consulta do CNPJ **27865757000102**:

```json
{
  "cnpj_raiz": "27865757",
  "razao_social": "GLOBO COMUNICACAO E PARTICIPACOES S/A",
  "capital_social": "6983568523.86",
  "responsavel_federativo": "",
  "atualizado_em": "2021-10-05T03:00:00.000Z",
  "porte": {
    "id": "05",
    "descricao": "Demais"
  },
  "natureza_juridica": {
    "id": "2054",
    "descricao": "Sociedade Anônima Fechada"
  },
  "qualificacao_do_responsavel": {
    "id": 10,
    "descricao": "Diretor "
  },
  "socios": [
    {
      "cpf_cnpj_socio": "***486498**",
      "nome": "RAYMUNDO COSTA PINTO BARROS",
      "tipo": "Pessoa Física",
      "data_entrada": "2021-03-15",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***720677**",
      "nome": "MANZAR GOMES FERES",
      "tipo": "Pessoa Física",
      "data_entrada": "2021-04-26",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***617850**",
      "nome": "CARLOS HENRIQUE SCHRODER",
      "tipo": "Pessoa Física",
      "data_entrada": "2014-12-12",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "61 a 70 anos",
      "atualizado_em": "2021-07-21T06:55:45.553Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***632567**",
      "nome": "JORGE LUIZ DE BARROS NOBREGA",
      "tipo": "Pessoa Física",
      "data_entrada": "2014-12-12",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "61 a 70 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***030727**",
      "nome": "MARCELO LUIS MENDES SOARES DA SILVA",
      "tipo": "Pessoa Física",
      "data_entrada": "2014-12-12",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***048947**",
      "nome": "PAULO DAUDT MARINHO",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "41 a 50 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***223047**",
      "nome": "ERICK DE MIRANDA BRETAS",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "41 a 50 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***492757**",
      "nome": "RICARDO CAPILLE WADDINGTON",
      "tipo": "Pessoa Física",
      "data_entrada": "2021-06-24",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***050187**",
      "nome": "PEDRO BORGES GARCIA",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***649137**",
      "nome": "MANUEL LUIS ROQUETE CAMPELO BELMAR DA COSTA",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    },
    {
      "cpf_cnpj_socio": "***834960**",
      "nome": "CLAUDIA FALCAO DA MOTTA",
      "tipo": "Pessoa Física",
      "data_entrada": "2020-01-16",
      "cpf_representante_legal": "***000000**",
      "nome_representante": null,
      "faixa_etaria": "51 a 60 anos",
      "atualizado_em": "2021-09-11T03:00:00.000Z",
      "pais_id": "1058",
      "qualificacao_socio": {
        "id": 10,
        "descricao": "Diretor "
      },
      "qualificacao_representante": null
    }
  ],
  "simples": null,
  "estabelecimento": {
    "cnpj": "27865757000102",
    "atividades_secundarias": [
      {
        "id": "5911102",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.11-1",
        "subclasse": "5911-1/02",
        "descricao": "Produção de filmes para publicidade"
      },
      {
        "id": "5911199",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.11-1",
        "subclasse": "5911-1/99",
        "descricao": "Atividades de produção cinematográfica, de vídeos e de programas de televisão não especificadas anteriormente"
      },
      {
        "id": "5912002",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.12-0",
        "subclasse": "5912-0/02",
        "descricao": "Serviços de mixagem sonora em produção audiovisual"
      },
      {
        "id": "5913800",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.1",
        "classe": "59.13-8",
        "subclasse": "5913-8/00",
        "descricao": "Distribuição cinematográfica, de vídeo e de programas de televisão"
      },
      {
        "id": "5920100",
        "secao": "J",
        "divisao": "59",
        "grupo": "59.2",
        "classe": "59.20-1",
        "subclasse": "5920-1/00",
        "descricao": "Atividades de gravação de som e de edição de música"
      },
      {
        "id": "6022501",
        "secao": "J",
        "divisao": "60",
        "grupo": "60.2",
        "classe": "60.22-5",
        "subclasse": "6022-5/01",
        "descricao": "Programadoras"
      },
      {
        "id": "6204000",
        "secao": "J",
        "divisao": "62",
        "grupo": "62.0",
        "classe": "62.04-0",
        "subclasse": "6204-0/00",
        "descricao": "Consultoria em tecnologia da informação"
      },
      {
        "id": "6319400",
        "secao": "J",
        "divisao": "63",
        "grupo": "63.1",
        "classe": "63.19-4",
        "subclasse": "6319-4/00",
        "descricao": "Portais, provedores de conteúdo e outros serviços de informação na Internet"
      },
      {
        "id": "6463800",
        "secao": "K",
        "divisao": "64",
        "grupo": "64.6",
        "classe": "64.63-8",
        "subclasse": "6463-8/00",
        "descricao": "Outras sociedades de participação, exceto holdings"
      },
      {
        "id": "7020400",
        "secao": "M",
        "divisao": "70",
        "grupo": "70.2",
        "classe": "70.20-4",
        "subclasse": "7020-4/00",
        "descricao": "Atividades de consultoria em gestão empresarial, exceto consultoria técnica específica"
      },
      {
        "id": "7490104",
        "secao": "M",
        "divisao": "74",
        "grupo": "74.9",
        "classe": "74.90-1",
        "subclasse": "7490-1/04",
        "descricao": "Atividades de intermediação e agenciamento de serviços e negócios em geral, exceto imobiliários"
      },
      {
        "id": "7739099",
        "secao": "N",
        "divisao": "77",
        "grupo": "77.3",
        "classe": "77.39-0",
        "subclasse": "7739-0/99",
        "descricao": "Aluguel de outras máquinas e equipamentos comerciais e industriais não especificados anteriormente, sem operador"
      },
      {
        "id": "7740300",
        "secao": "N",
        "divisao": "77",
        "grupo": "77.4",
        "classe": "77.40-3",
        "subclasse": "7740-3/00",
        "descricao": "Gestão de ativos intangíveis não financeiros"
      },
      {
        "id": "9001902",
        "secao": "R",
        "divisao": "90",
        "grupo": "90.0",
        "classe": "90.01-9",
        "subclasse": "9001-9/02",
        "descricao": "Produção musical"
      },
      {
        "id": "9319101",
        "secao": "R",
        "divisao": "93",
        "grupo": "93.1",
        "classe": "93.19-1",
        "subclasse": "9319-1/01",
        "descricao": "Produção e promoção de eventos esportivos"
      }
    ],
    "cnpj_raiz": "27865757",
    "cnpj_ordem": "0001",
    "cnpj_digito_verificador": "02",
    "tipo": "Matriz",
    "nome_fantasia": "TV/REDE/CANAIS/G2C+GLOBO SOMLIVRE GLOBO.COM GLOBOPLAY",
    "situacao_cadastral": "Ativa",
    "data_situacao_cadastral": "2005-11-03",
    "data_inicio_atividade": "1986-01-31",
    "nome_cidade_exterior": null,
    "tipo_logradouro": "RUA",
    "logradouro": "LOPES QUINTAS",
    "numero": "303",
    "complemento": null,
    "bairro": "JARDIM BOTANICO",
    "cep": "22460901",
    "ddd1": "21",
    "telefone1": "21554551",
    "ddd2": "21",
    "telefone2": "21554552",
    "ddd_fax": "21",
    "fax": "25408773",
    "email": null,
    "situacao_especial": null,
    "data_situacao_especial": null,
    "atualizado_em": "2021-09-11T03:00:00.000Z",
    "atividade_principal": {
      "id": "6021700",
      "secao": "J",
      "divisao": "60",
      "grupo": "60.2",
      "classe": "60.21-7",
      "subclasse": "6021-7/00",
      "descricao": "Atividades de televisão aberta"
    },
    "pais": {
      "id": "1058",
      "iso2": "BR",
      "iso3": "BRA",
      "nome": "Brasil",
      "comex_id": "105"
    },
    "estado": {
      "id": 19,
      "nome": "Rio de Janeiro",
      "sigla": "RJ",
      "ibge_id": 33
    },
    "cidade": {
      "id": 3243,
      "nome": "Rio de Janeiro",
      "ibge_id": 3304557,
      "siafi_id": "6001"
    },
    "motivo_situacao_cadastral": null,
    "inscricoes_estaduais": [
      {
        "inscricao_estadual": "84295760",
        "ativo": true,
        "atualizado_em": "2021-10-04T01:27:53.685Z",
        "estado": {
          "id": 19,
          "nome": "Rio de Janeiro",
          "sigla": "RJ",
          "ibge_id": 33
        }
      },
      {
        "inscricao_estadual": "84347353",
        "ativo": false,
        "atualizado_em": "2021-10-04T01:27:53.685Z",
        "estado": {
          "id": 19,
          "nome": "Rio de Janeiro",
          "sigla": "RJ",
          "ibge_id": 33
        }
      },
      {
        "inscricao_estadual": "113717433112",
        "ativo": false,
        "atualizado_em": "2021-10-05T03:00:00.000Z",
        "estado": {
          "id": 26,
          "nome": "São Paulo",
          "sigla": "SP",
          "ibge_id": 35
        }
      }
    ]
  }
}
```

### Conclusão

Utilizando a API do CNPJ.ws você obtém os dados das empresas brasileiras de forma simples e fácil, dê uma olhada em nossa [documentação](https://docs.cnpj.ws/).

Para saber mais sobre nossos planos e formas de pagamento acesse [CNPJ.ws](https://www.cnpj.ws/).

Qualquer dúvida nós estamos aqui para te apoiar, mande um e-mail para <contato@cnpj.ws>!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cnpj.ws/blog/consulta-cnpj-php.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.