---
title: "Listar produtos"
method: GET
path: "/api/v1/products"
tags: ["Produtos"]
---

# Listar produtos

`GET /api/v1/products`

## Query parameters

- `name` string
- `code` string
- `barcode` string
- `externalReference` string
- `page` integer
- `size` integer

## Response `200`

OK

- PageProductOutputDto
  - `totalElements` integer
  - `totalPages` integer
  - `last` boolean
  - `pageable` PageableObject
    - `paged` boolean
    - `unpaged` boolean
    - `pageSize` integer
    - `pageNumber` integer
    - `offset` integer
    - `sort` SortObject[]
      - `direction` string
      - `nullHandling` string
      - `ascending` boolean
      - `property` string
      - `ignoreCase` boolean
  - `numberOfElements` integer
  - `first` boolean
  - `size` integer
  - `content` ProductOutputDto[]
    - `name` string, required — Nome ou descrição do produto.
    - `code` string, required — Código do produto.
    - `ncm` string, required — Nomenclatura Comum do Mercosul (NCM).
    - `unit` string, required — Unidade de comercialização do produto.
    - `barcode` string — Código de barras do produto (GTIM).
    - `salePrice` number — Preço de venda.
    - `externalReference` string — Identificador único do produto no seu sistema.
    - `stockBalance` number — Saldo em estoque.
    - `deleted` boolean — Produto excluido True/False
    - `id` integer — Identificador único do produto.
    - `cClassTrib` string — Classificação Tributária. Este campo será considerado somente para empresas do Regime Normal. Ou seja, este campo, mesmo se preenchido, será desconsiderado para empresas do Simples Nacional e MEI.
  - `number` integer
  - `sort` SortObject[]
    - `direction` string
    - `nullHandling` string
    - `ascending` boolean
    - `property` string
    - `ignoreCase` boolean
  - `empty` boolean

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/baseerp/apis/api-base-by-asaas.md) · [All operations](https://skmtc.dev/baseerp/apis/api-base-by-asaas/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/baseerp/api-base-by-asaas/revisions/408ce44b0d29/schema)