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

# Listar produtos

`GET /produtos`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/produtos`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Método utilizado para fazer uma busca dos produtos, sendo possível
utilizar os campos do produto como filtro. O retorno deste método
será um array de objetos de produtos. Os produtos serão retornados
de maneira resumida; caso queira o produto completo, deve ser
buscado pelo **ID** através do endpoint **Buscar produto** abaixo.

Com exceção dos campos `variacoes`, `imagens` e `promocao`, todos
os demais podem ser utilizados como filtro. Todos podem ser
filtrados com o seu respectivo nome, com exceção do campo
`categorias`, que deve ser filtrado como `categoria`.

Os campos `descricao`, `codigo` e `detalhes` fazem a busca parcial,
ou seja, qualquer produto que contenha parte do texto informado
será retornado. Os demais campos fazem busca exata (equivalente
ao operador `=`).

## Query parameters

- `descricao` string
- `skip` integer
- `limit` integer
- `sort` string
- `sortType` 'ASC' | 'DESC'
- `categoria` string

## Response `200`

Lista de produtos (resumida).

- ProdutoListItem[]
  - `id` string
  - `descricao` string
  - `preco` number
  - `unidadeVenda` string
  - `destaque` boolean
  - `codigo` string, nullable
  - `exibir` boolean
  - `dt_cadastro` string
  - `dt_alteracao` string

## Other responses

- `401`: Credenciais informadas inválidas.

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)