API do NCM Brasil

Consulta de NCM, CEST e alíquota de ICMS por estado, com fonte oficial e data de vigência.

Comece em 30 segundos

Crie sua chave gratuita em /api/painel e envie no header X-Api-Key.

Planos

plano	por minuto	por dia	preço
Gratuito	10	100	R$ 0
Pro	sem limite		R$ 29,90/mês

Assinatura mensal, sem fidelidade, cancela quando quiser. Pagamento por PIX, boleto ou cartão.

Envie a chave no header X-Api-Key ou no parâmetro ?api_key=. Sem chave, a resposta é 401.

curl -H "X-Api-Key: SUA_CHAVE" "https://www.ncmbrasil.com.br/api/v1/ncm/85171231"

Dados de um NCM: descrição completa, capítulo, vigência, CEST relacionados e a alíquota interna de ICMS de cada estado.

parâmetro	onde	obrigatório	descrição
`codigo`	path	sim	NCM de 2 a 8 dígitos, com ou sem pontos

curl -H "X-Api-Key: SUA_CHAVE" "https://www.ncmbrasil.com.br/api/v1/ncm/85171231"

Dados de um CEST: segmento, item, descrição e os NCM que ele abrange.

parâmetro	onde	obrigatório	descrição
`codigo`	path	sim	CEST de 7 dígitos

curl -H "X-Api-Key: SUA_CHAVE" "https://www.ncmbrasil.com.br/api/v1/cest/2106400"

Alíquota interna, FCP, carga usual e as alíquotas interestaduais de saída do estado.

parâmetro	onde	obrigatório	descrição
`uf`	path	sim	sigla do estado

curl -H "X-Api-Key: SUA_CHAVE" "https://www.ncmbrasil.com.br/api/v1/icms/sp"

Busca de NCM por descrição.

parâmetro	onde	obrigatório	descrição
`q`	query	sim	texto da busca
`limite`	query	não	até 50 (padrão 20)

curl -H "X-Api-Key: SUA_CHAVE" "https://www.ncmbrasil.com.br/api/v1/buscar?q=notebook&limite=20"

código	quando acontece
`401`	sem chave ou chave inválida
`403`	chave desativada
`429`	cota do plano gratuito atingida

A especificação completa está em /api/openapi.json — dá para importar no Postman, no Insomnia ou gerar cliente automático.