v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
NCM

Consultar

Esta operação permite consultar códigos NCM utilizando diversos critérios de pesquisa. Você pode pesquisar por:

  • codigo: Pesquise pela parte inicial do código NCM
  • descricao: Pesquisa por parte da descrição do código NCM
  • capitulo, posicao, subposicao1, subposicao2, item1 e item2: Pesquisa exata informando qualquer uma das partes do código NCM

A API devolve apenas 50 registros por vez. Para buscar os demais registros, utilize o parâmetro offset. O cabeçalho HTTP X-Total-Count representa o número total de ocorrências da pesquisa.

get/ncms

Query parameters

codigostring

Pesquise pela parte inicial do código NCM

descricaostring

Pesquisa por parte da descrição do código NCM

capitulostring

Pesquisa exata pelo capítulo do código NCM (2 dígitos)

posicaostring

Pesquisa exata pela posição do código NCM (2 dígitos)

subposicao1string

Pesquisa exata pela subposição 1 do código NCM (1 dígito)

subposicao2string

Pesquisa exata pela subposição 2 do código NCM (1 dígito)

item1string

Pesquisa exata pelo item 1 do código NCM (1 dígito)

item2string

Pesquisa exata pelo item 2 do código NCM (1 dígito)

offsetinteger

Número de registros a serem ignorados para paginação (máximo 50 registros por página)

Response

Requisição processada com sucesso

codigostring

Código NCM completo (8 dígitos)

descricao_completastring

Descrição completa do código NCM

capitulostring

Capítulo do código NCM (2 dígitos)

posicaostring

Posição do código NCM (2 dígitos)

subposicao1string

Subposição 1 do código NCM (1 dígito)

subposicao2string

Subposição 2 do código NCM (1 dígito)

item1string

Item 1 do código NCM (1 dígito)

item2string

Item 2 do código NCM (1 dígito)

Example response

[
  {
    "codigo": "90049090",
    "descricao_completa": "Óculos para correção, proteção ou outros fins, e artigos semelhantes. Outros Outros",
    "capitulo": "90",
    "posicao": "04",
    "subposicao1": "9",
    "subposicao2": "0",
    "item1": "9",
    "item2": "0"
  }
]