Consulta CNPJ

Informações e detalhes para consulta do documento brasileiro CNPJ

Este serviço é destinado para consultar dados de uma pessoa jurídica brasileira a partir do seu documento CNPJ.

Os dados disponíveis nas consultas é o resultado de cruzamento de bases da Receita Federal e webscraping de dados públicos.

Requisição

GET https://api-v3.smsfire.com.br/bigdata/cnpj/:input

Rate Limiter: Este serviço possui um limite global de 30 requisições por minuto a partir do mesmo IP.

Parâmetros de requisição

Parâmetro	Tipo	Descrição	Exemplo
input*	string	Documento CNPJ a ser pesquisado	19100200000108

Exemplos de requisição

Node.JS

var axios = require("axios").default;

const input = "19100200000108";

var options = {
  method: 'GET',
  url: `https://api-v3.smsfire.com.br/bigdata/cnpj/${input}`,
  headers: {Username: 'seu_usuario', Api_Token: 'seu_token'}
};

axios.request(options).then(function (response) {
  console.log(response.data);
}).catch(function (error) {
  console.error(error);
});

Php

<?php

$endpoint = "https://api-v3.smsfire.com.br/bigdata/cnpj/";
$endpoint .= "19100200000108";

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => $endpoint,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "Api_Token: seu_token",
        "Username: seu_usuario",
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}

C-Sharp

using System.Net.Http;
using Microsoft.AspNetCore.WebUtilities; // precisa do pacote Microsoft.AspNetCore.WebUtilities

var client = new HttpClient();

var input = "19100200000108";
var endpoint = $"https://api-v3.smsfire.com.br/bigdata/cnpj/{input}";

var request = new HttpRequestMessage
{
    Method = HttpMethod.Get,
    RequestUri = new Uri(endpoint),
    Headers =
    {
        { "Api_Token", "seu_token" },
        { "Username", "seu_usuario" }
    }
};

using var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();

var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

Shell/cURL

curl --request GET \
  --url 'https://api-v3.smsfire.com.br/bigdata/cnpj/19100200000108' \
  --header 'Api_Token: seu_token' \
  --header 'Username: seu_usuario'

Somente consultas com dados disponíveis serão tarifadas.

Response

O conjunto de dados retornados será em formato JSON com detalhes da pesquisa ou possível falha da requisição

200 - OK

{
	"id": "0199b9bf-3eb4-707c-90e9-ce9c3c306494",
	"ip": "127.0.0.1",
	"doc": "19100200000108",
	"fiscalName": "empresa de sucesso ltda",
	"brandName": "empresa de sucesso",
	"capital": 30000,
	"working": 2,
	"isSimples": true,
	"isMei": false,
	"type": 1,
	"cnae": "6120599",
	"cnaes": ["6203100","6209100"],
	"openDate": "2018-11-06",
	"updateDate": "2018-11-06",
	"emails": ["[email protected]"],
	"phones": [
		{
			"prefix": "55",
			"area": "11",
			"phone": "944556677",
			"national": "11944556677",
			"international": "5511944556677"
		},
	],
	"addresses": [
		{
			"street": "avenida itália",
			"number": "100",
			"complement": "sala 10b",
			"neighborhood": "jardim eucalipto",
			"city": "suzano",
			"state": "sp",
			"country": "brasil",
			"zipcode": "12010000",
			"updated_at": "2025-06-26T01:48:10.000Z"
		}
	],
	"associates": [
		{
			"doc": "12365478909",
			"name": "joao da silva junior"
		}
	]
}

404 - Not found

Esse código de erro será lançado quando a consulta não possuir dados disponíveis em nossas bases de dados.

{
	"id": "0199b9bf-3eb4-707c-90e9-ce9c3c306494",
	"ip": "127.0.0.1",
	"status": "NOT_FOUND"
}

4xx - Erro

Erros poderão ser facilmente filtrados a partir dos códigos HTTP retornados e adicionalmente detalhes do erro serão incluídos no JSON que seguirá o seguinte formato:

{
	"message": "Not Available Balance",
	"error": "Forbidden",
	"statusCode": 403
}

5xx - Erro

Requisições que tenham o retorno de algum código HTTP deste nível é devido a falhas internas da API ou servidor.

Neste tipo de situação, entre em contato com a equipe de suporte

Tabela de parâmetros

Parâmetro	Tipo	Descrição
id	string Padrão UUID	Identificador único da pesquisa
ip	string	Ip de onde se originou o request a API
doc	string	Documento a pessoa pesquisada
fiscalName	string	Razão social da empresa
brandName	string | null	Nome fantasia
capital	number	Capital social
working	number	Situação cadastral
isSimple	boolean	Participante ddo Simples Nacional
isMei	boolean	Trata-se e Micro Empreendedor Individual
type	number	Porte
cane	string	CNAE principal
cnaes	string[]	CNAEs secundários
openDate	string | Date AAAA-MM-DD	Data de abertura
updateDate	string | Date AAAA-MM-DD	Data última atualização cadastral
emails	string[]	Relação de e-mails
phones	array	Matriz com relação de telefones
phones[].prefix	string	Código DDI do telefone
phones[].area	string	Código de área
phones[].phone	string	Número de telefone em formato local
phones[].national	string	Número de telefone em formato nacional
phones[].international	string	Número de telefone em formato internacional
addresses	array	Matriz com relação de endereços
addresses[].street	string	Nome da rua
addresses[].number	string | null	Número do endereço
addresses[].complement	string | null	Complemento do endereço
addresses[].neighborhood	string | null	Bairro
addresses[].city	string	Cidade
addresses[].state	string	Estado
addresses[].country	string	País
addresses[].zipcode	string	Código postal (CEP)
addresses[].updated_at	string | Date	Data da última atualização do item
associates	array	Matriz com relação de sócios
associates[].doc	string	Cpf do sócio
associates[].name	string	Nome completo do sócio

working

Situação cadastral do CNPJ.

Valor	Descrição
1	Anulado
2	Ativo
3	Suspenso
4	Irregular

type

Porte da empresa

Valor	Descrição
1	Microempresa - ME
3	Empresa de pequeno porte - EPP
5	Demais portes (SA, LTDA, EIRELI)