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
Autorizações
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
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-09T05:37:55.376Z"
}
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);
}
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"
}
Atualizado
Isto foi útil?