---
title: "NCMs - Listar."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-RecursosAdicionais-Ncm-Listar/get"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# NCMs - Listar.

`GET` `/api/v1/RecursosAdicionais/Ncm/Listar`

Consulta a tabela de <strong>Nomenclatura Comum do Mercosul (NCM)</strong>, utilizada para a classificação fiscal de mercadorias no comércio internacional e doméstico. ⚠️ **VIGÊNCIA**: Atente-se aos campos de data de vigência. Consultar NCMs expiradas pode ocasionar rejeições no momento da emissão do documento fiscal eletrônico. 🧪 **TESTE**: Em ambiente de sandbox, a tabela reflete a estrutura oficial, permitindo validar se a lógica de busca por descrição ou código atende aos requisitos do PDV ou ERP. 🔍 **BUSCA SEMÂNTICA**: O parâmetro 'busca' realiza uma varredura tanto na descrição do item quanto no segmento relacionado, facilitando a identificação correta da mercadoria.

## Query parameters

- `codigoNcm` (string, optional) - Filtrar pelo código NCM exato.
- `extensaoTipi` (integer, int32, optional) - Filtrar pela extensão TIPI (EX).
- `busca` (string, optional) - Filtrar por campo de busca genérico.
- `dataInicioVigenciaInicial` (string, date, optional) - Data de início de vigência "a partir de".
- `dataInicioVigenciaFinal` (string, date, optional) - Data de início de vigência "até".
- `dataFimVigenciaInicial` (string, date, optional) - Data de fim de vigência "a partir de".
- `dataFimVigenciaFinal` (string, date, optional) - Data de fim de vigência "até".
- `offset` (integer, int32, optional) - Quantidade de registros a serem pulados (deslocamento).
- `limit` (integer, int32, optional) - Limite máximo de registros por página.

## Header parameters

- `DocumentoEmissor` (string, optional) - Documento do emissor.

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
paths:
  /api/v1/RecursosAdicionais/Ncm/Listar:
    get:
      tags:
        - RecursosAdicionais
      summary: NCMs - Listar.
      description: >-
        Consulta a tabela de <strong>Nomenclatura Comum do Mercosul
        (NCM)</strong>, utilizada para a classificação fiscal de mercadorias no
        comércio internacional e doméstico.


        ⚠️ **VIGÊNCIA**: Atente-se aos campos de data de vigência. Consultar
        NCMs expiradas pode ocasionar rejeições no momento da emissão do
        documento fiscal eletrônico.


        🧪 **TESTE**: Em ambiente de sandbox, a tabela reflete a estrutura
        oficial, permitindo validar se a lógica de busca por descrição ou código
        atende aos requisitos do PDV ou ERP.


        🔍 **BUSCA SEMÂNTICA**: O parâmetro 'busca' realiza uma varredura tanto
        na descrição do item quanto no segmento relacionado, facilitando a
        identificação correta da mercadoria.
      parameters:
        - name: codigoNcm
          in: query
          description: Filtrar pelo código NCM exato.
          schema:
            type: string
        - name: extensaoTipi
          in: query
          description: Filtrar pela extensão TIPI (EX).
          schema:
            type: integer
            format: int32
        - name: busca
          in: query
          description: Filtrar por campo de busca genérico.
          schema:
            type: string
        - name: dataInicioVigenciaInicial
          in: query
          description: Data de início de vigência "a partir de".
          schema:
            type: string
            format: date
        - name: dataInicioVigenciaFinal
          in: query
          description: Data de início de vigência "até".
          schema:
            type: string
            format: date
        - name: dataFimVigenciaInicial
          in: query
          description: Data de fim de vigência "a partir de".
          schema:
            type: string
            format: date
        - name: dataFimVigenciaFinal
          in: query
          description: Data de fim de vigência "até".
          schema:
            type: string
            format: date
        - name: offset
          in: query
          description: Quantidade de registros a serem pulados (deslocamento).
          schema:
            type: integer
            format: int32
            default: 1
        - name: limit
          in: query
          description: Limite máximo de registros por página.
          schema:
            type: integer
            format: int32
            default: 10
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ListarNcmsViewModelListPaginationResponse"
            application/json:
              schema:
                $ref: "#/components/schemas/ListarNcmsViewModelListPaginationResponse"
            text/json:
              schema:
                $ref: "#/components/schemas/ListarNcmsViewModelListPaginationResponse"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    ListarNcmsViewModelListPaginationResponse:
      type: object
      properties:
        offset:
          type: integer
          format: int32
        limit:
          type: integer
          format: int32
        total:
          type: integer
          format: int32
        data:
          type: array
          items:
            $ref: "#/components/schemas/ListarNcmsViewModel"
          nullable: true
      additionalProperties: false
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
    ListarNcmsViewModel:
      type: object
      properties:
        codigoNcm:
          type: string
          description: Código da Nomenclatura Comum do Mercosul.
          nullable: true
        extensaoTipi:
          type: integer
          description: Código de extensão da TIPI (Tabela de Incidência do IPI).
          format: int32
        descricao:
          type: string
          description: Descrição completa da mercadoria ou serviço vinculada ao NCM.
          nullable: true
        inicioVigencia:
          type: string
          description: Data de início da vigência do código NCM.
          format: date
          example: 2025-03-31
        fimVigencia:
          type: string
          description: Data de término da vigência (opcional).
          format: date
          nullable: true
      additionalProperties: false
      description: Dados para a listagem de NCMs.
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```