---
title: "Consultar"
method: GET
path: "/ncms"
tags: ["NCM"]
---

# Consultar

`GET /ncms`

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.

## Query parameters

- `codigo` string
- `descricao` string
- `capitulo` string
- `posicao` string
- `subposicao1` string
- `subposicao2` string
- `item1` string
- `item2` string
- `offset` integer

## Response `200`

Requisição processada com sucesso

- NCMResponse[]
  - `codigo` string — Código NCM completo (8 dígitos)
  - `descricao_completa` string — Descrição completa do código NCM
  - `capitulo` string — Capítulo do código NCM (2 dígitos)
  - `posicao` string — Posição do código NCM (2 dígitos)
  - `subposicao1` string — Subposição 1 do código NCM (1 dígito)
  - `subposicao2` string — Subposição 2 do código NCM (1 dígito)
  - `item1` string — Item 1 do código NCM (1 dígito)
  - `item2` string — Item 2 do código NCM (1 dígito)

## Other responses

- `401` — Não autorizado

---

[API](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele.md) · [All operations](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/focusnfe/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/revisions/a32e528fc383/schema)