Como consultar CNPJ via API no C# (.NET).

Por que usar a API do openCNPJ no C#

No ecossistema .NET, a consulta de CNPJ é comum em ERPs, sistemas fiscais e APIs ASP.NET. Com o HttpClient e o System.Text.Json, você recebe os dados da empresa em poucas linhas, sem pacotes de terceiros.

• Grátis, sem chave de acesso e sem cadastro.
• Resposta em JSON com razão social, situação cadastral, endereço, CNAEs, sócios e Simples Nacional.
• Aceita o CNPJ numérico e o novo CNPJ alfanumérico.
• Limite de 10 requisições por segundo por IP.

O que você precisa

.NET 6 ou superior. System.Net.Http.Json já vem no SDK.

Consultar um CNPJ no C#

O endpoint é GET https://api.opencnpj.com.br/cnpj/{cnpj}. Envie o CNPJ com 14 caracteres, sem pontos, barra ou hífen. O exemplo abaixo consulta o CNPJ 06.990.590/0001-23:

using System.Net.Http.Json;
using System.Text.Json;

var cnpj = "06990590000123";
using var http = new HttpClient();

var empresa = await http.GetFromJsonAsync<JsonElement>(
    $"https://api.opencnpj.com.br/cnpj/{cnpj}");

Console.WriteLine(empresa.GetProperty("razao_social").GetString());
Console.WriteLine(empresa.GetProperty("estabelecimento")
    .GetProperty("situacao_cadastral").GetString());

.NET 6+. GetFromJsonAsync lança HttpRequestException em respostas de erro.

Remover a máscara do CNPJ

Se o CNPJ vem formatado (06.990.590/0001-23) de um formulário, banco de dados ou planilha, limpe a pontuação antes de montar a URL. A mesma regra funciona para o CNPJ alfanumérico:

using System.Text.RegularExpressions;

static string LimparCnpj(string cnpj) =>
    Regex.Replace(cnpj, "[^0-9A-Za-z]", "").ToUpperInvariant();

var cnpj = LimparCnpj("06.990.590/0001-23"); // "06990590000123"

Campos mais usados da resposta

A lista completa de campos está na documentação da API.

Tratando erros

Verifique o status HTTP antes de ler o JSON. C#: use HttpResponseMessage.StatusCode (usando GetAsync).

Os erros também vêm em JSON, com os campos status, titulo e detalhes.

Boas práticas

• Defina um timeout na requisição, por exemplo com HttpClient.Timeout.
• Guarde o resultado em cache se o mesmo CNPJ for consultado com frequência.
• Em processamentos em lote, respeite o limite de 10 requisições por segundo.
• Os dados refletem a base pública mais recente processada e não substituem certidões oficiais.

Perguntas frequentes

A API de CNPJ do openCNPJ é gratuita?

Sim, 100% grátis. Não há chave de acesso nem cadastro. O limite é de 10 requisições por segundo por IP.

Funciona no .NET Framework 4.x?

Sim. O HttpClient existe desde o .NET Framework 4.5. Use GetStringAsync e desserialize com System.Text.Json ou Newtonsoft.Json.

Devo criar um HttpClient por consulta?

Não. Reaproveite uma instância (ou use IHttpClientFactory no ASP.NET) para evitar esgotar conexões.

De onde vêm os dados do CNPJ?

Dos dados abertos do CNPJ publicados pela Receita Federal, complementados por bases públicas. Os dados podem ter defasagem e não substituem certidões oficiais. Veja a origem dos dados.