Validando Inscrição no Suframa na API Pública

Na API Pública é possível fazer até 3 consultas por minuto 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://publica.cnpj.ws/suframa

Exemplos de Requisição

Consulta de uma inscrição no Suframa

POSThttps://publica.cnpj.ws/suframa

Query 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

JavaScriptCurlPython

const response = await fetch('https://publica.cnpj.ws/suframa', {
    method: 'POST',
    headers: {
      "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": false,
  "atualizado_em": "2025-01-17T21:39:52.735Z"
}

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 cnpj = "61940292006682";
  const incricao = "210140267";

  const empresa = await consultarCNPJ.suframa(cnpj, incricao);
  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"
}