---
title: "Listar SKUs por estoque"
method: GET
path: "/{alias}/catalog/skus/stocks/{stock}"
tags: ["Catálogo - Estoques de SKU"]
---

# Listar SKUs por estoque

`GET /{alias}/catalog/skus/stocks/{stock}`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/catalog/skus/stocks/{stock}`
- Auth: API key in header `User-Token` and API key in header `User-Secret-Key`

Retorna os dados básicos dos SKUs que possuem vínculo com o estoque informado

## Path parameters

- `alias` string, required
- `stockId` integer, required

## Query parameters

- `stock_status` 'in_stock' | 'out_of_stock' | 'low_stock'

## Response `200`

Lista de SKUs do estoque

- object: Representa uma paginação com meta
  - `data` SkuByStock[]: Lista de SKUs vinculados ao estoque.
    - `product_id` integer: ID do produto
    - `sku` string: Código do SKU
    - `sku_id` integer: ID do SKU
    - `title` string: Nome do produto
    - `image` string, nullable: URL da imagem do SKU
    - `variations` object[]: Variações do SKU
    - `total_in_stock` integer: Quantidade total em estoque
    - `stock_status` 'in_stock' | 'out_of_stock' | 'low_stock': Status do estoque
    - `min_quantity` integer: Quantidade mínima do estoque
    - `stock_id` integer: ID do estoque
    - `total_reservation` integer: Total de reservas
    - `reservations` object[]: Lista de reservas do SKU
      - `status` string, nullable: Status do pedido
      - `client_name` string, nullable: Nome do cliente
      - `order_number` string, nullable: Número do pedido
  - `meta` object: Metadados da resposta.
    - `pagination` object: Dados de paginação do resultado.
      - `total` integer: Quantidade total de registros encontrados, considerando todas as páginas.
      - `count` integer: Quantidade de registros retornados na página atual.
      - `per_page` integer: Quantidade máxima de registros por página.
      - `current_page` integer: Número da página atual.
      - `total_pages` integer: Quantidade total de páginas do resultado.
      - `links` object: Links de navegação entre as páginas do resultado.
        - `previous` string: URL da página anterior, ausente quando a página atual é a primeira.
        - `next` string: URL da próxima página, ausente quando a página atual é a última.

## Other responses

- `404`: Estoque não encontrado

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) - [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yampi/apis/yampi-api/revisions/74739ec8876f?raw)