Validando Inscrição no Suframa

Na API Comercial é possível fazer consultas de uma inscrição no Suframa utilizando o método POST.

Lembre-se de enviar o CNPJ sem os caracteres especiais.

Método: POST

Endpoint: https://comercial.cnpj.ws/suframa

Exemplos de Requisição

Consulta de uma inscrição no Suframa

POSThttps://comercial.cnpj.ws/suframa

Authorization

x_api_tokentoken

Query parameters

Header parameters

Body

application/json

cnpj*string

CNPJ da empresa

inscricao*string

Inscrição no Suframa

Response

200401404

Sucesso

Body

application/json

cnpj_raizstring

cnpjstring

inscricao_suframastring

ativoboolean

atualizado_emstring (date-time)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://comercial.cnpj.ws/suframa', {
    method: 'POST',
    headers: {
      "x_api_token": "x_api_token <apiKey>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "cnpj": "text",
      "inscricao": "text"
    }),
});
const data = await response.json();

Response

200401404

{
  "cnpj_raiz": "text",
  "cnpj": "text",
  "inscricao_suframa": "text",
  "ativo": true,
  "atualizado_em": "2025-02-05T04:31:09.668Z"
}

Nós possuímos um pacote que pode te ajudar na integração com JavaScript:

yarn add consultar-cnpj

const consultarCNPJ = require("consultar-cnpj");

async function getCNPJ() {
  const token = "INFORME O SEU TOKEN DE ACESSO";
  const cnpj = "61940292006682";
  const incricao = "210140267";

  const empresa = await consultarCNPJ.suframa(cnpj, incricao, token);
  console.log(empresa);
}

Mais informações do pacote

Exemplo de Retorno

Abaixo um exemplo do JSON retornado ao se buscar pelo CNPJ 61940292006682 e inscrição 210140267:

{
  "cnpj_raiz": "61940292",
  "cnpj": "61940292006682",
  "inscricao_suframa": "210140267",
  "ativo": true,
  "atualizado_em": "2022-01-16T12:28:32.384Z"
}