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

post

Parâmetros de consulta

tokenstringOpcional

Token de autenticação (opcional, pode ser passado no header como x_api_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: publica.cnpj.ws
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-10T22:22:10.273Z"
}

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