---
title: "Listar SKUs"
method: GET
path: "/{alias}/catalog/skus"
tags: ["Catálogo - SKUs"]
---

# Listar SKUs

`GET /{alias}/catalog/skus`

Retorna uma lista de SKUs disponíveis

## Path parameters

- `alias` string, required

## Query parameters

- `stock_quantity` integer
- `stock_min_quantity` integer

## Response `200`

SKUs encontrados com sucesso

- object — Representa uma paginação com meta
  - `data` object[]
    - `id` integer — ID do SKU
    - `product_id` integer — ID do produto ao qual o SKU pertence
    - `seller_id` integer — ID do vendedor
    - `sku` string — Código do SKU
    - `token` string — Token único do SKU
    - `erp_id` string — ID do SKU no ERP
    - `blocked_sale` boolean — Vendas bloqueadas
    - `barcode` string — Código de barras do SKU
    - `title` string — Título completo do SKU
    - `allow_sell_without_customization` boolean — Permite vender sem personalização obrigatória
    - `price_cost` number, float — Preço de custo do SKU
    - `price_sale` number, float — Preço de venda do SKU
    - `price_discount` number, float — Preço com desconto aplicado
    - `combinations` string[] — Combinações de variações associadas ao SKU
    - `weight` number, float — Peso do SKU em kg
    - `height` number, float — Altura do SKU em cm
    - `width` number, float — Largura do SKU em cm
    - `length` number, float — Comprimento do SKU em cm
    - `quantity_managed` boolean — Indica se o controle de estoque está habilitado
    - `availability` integer — Quantidade disponível em estoque
    - `availability_soldout` integer — Quantidade disponível mesmo após esgotado
    - `order` integer — Ordem de exibição do SKU para a página de produtos
    - `variations` object[] — Lista de variações do produto
      - `name` string — Nome da variação
      - `id` integer — ID da variação
      - `value` string — Valor da variação
      - `value_id` integer — ID do valor da variação
    - `days_availability_formated` string — Disponibilidade formatada em dias
    - `total_in_stock` integer — Quantidade total em estoque
    - `stock_status` 'in_stock' | 'out_of_stock' | 'low_stock' — Status do estoque
    - `total_orders` integer — Número total de pedidos realizados
    - `image_reference_sku_id` integer — ID do SKU de referência da imagem
    - `purchase_url` string, url — URL para a compra do produto
    - `created_at` BaseTimestamp
      - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer — Número de representação do timezone.
      - `timezone` string — Fuso horário associado.
    - `updated_at` BaseTimestamp
      - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
      - `timezone_type` integer — Número de representação do timezone.
      - `timezone` string — Fuso horário associado.
    - `customizations` object — Personalizações do produto
      - `data` Customization[]
        - `id` integer — ID do produto customizado
        - `name` string
        - `price` number — Preço do produto customizado
        - `description` string
        - `type` string
        - `required` boolean — Indica se é obrigatório ou não
        - `allowed_values` string — Valores permitidos para o campo
        - `max_chars` integer — Há uma limitação de caracteres na customização. Exemplo: o número da camisa deve ter apenas 2 caracteres.
        - `products_ids` integer[] — IDs dos produtos que possuem essa customização
        - `values` string[]
  - `meta` object
    - `pagination` object
      - `total` integer
      - `count` integer
      - `per_page` integer
      - `current_page` integer
      - `total_pages` integer
      - `links` object
        - `previous` string
        - `next` string

## Other responses

- `404` — SKUs não encontrados

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)