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

post

Autorizações

x_api_tokentoken

Parâmetros de consulta

tokenstringOpcional

Token de autenticação (opcional, pode ser passado no header como x_api_token)

Parâmetros de cabeçalho

x_api_tokenstringOpcional

Token de autenticação (opcional, pode ser passado na query como token)

Corpo

cnpjstringObrigatório

CNPJ da empresa

inscricaostringObrigatório

Inscrição no Suframa

Respostas

200

Sucesso

application/json

401

Não autenticado

application/json

404

Não encontrado

application/json

post

HTTPcURLJavaScriptPython

POST /suframa HTTP/1.1
Host: comercial.cnpj.ws
x_api_token: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "cnpj": "text",
  "inscricao": "text"
}

{
  "cnpj_raiz": "text",
  "cnpj": "text",
  "inscricao_suframa": "text",
  "ativo": true,
  "atualizado_em": "2025-07-15T13:16:45.262Z"
}

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"
}