---
title: "Listar coleções ativas de uma loja"
method: GET
path: "/{alias}/public/catalog/collections/active"
tags: ["Público - Catálogo"]
---

# Listar coleções ativas de uma loja

`GET /{alias}/public/catalog/collections/active`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/public/catalog/collections/active`
- Auth: none required

Retorna as coleções ativas e dentro do período de validade, com banners incluídos por padrão

## Path parameters

- `alias` string, required

## Query parameters

- `page` integer
- `limit` integer
- `featured` 0 | 1
- `q` string

## Response `200`

Lista de coleções ativas da loja

- object
  - `data` object[]: Coleções ativas e dentro do período de validade, ordenadas conforme os filtros informados.
    - `id` integer: ID da coleção.
    - `name` string: Nome da coleção.
    - `url` string, uri: URL completa da página da coleção na loja.
    - `url_path` string: Caminho relativo para a URL da coleção.
    - `banners` object: Banners vinculados à coleção, incluídos por padrão.
      - `data` BannersPublic[]: Lista de banners da coleção.
        - `data` object[], required: Lista dos banners retornados.
          - `id` integer, required: ID do banner.
          - `product_id` integer, nullable: ID do produto vinculado ao banner, quando o banner apontar para um produto específico.
          - `type` string, required: Tipo do banner: `image` (banner de imagem) ou `product` (banner vinculado a um produto, exigindo `product_id`).
          - `active` boolean, required: Indica se o banner está ativo.
          - `home` boolean, required: Indica se o banner é exibido na página inicial.
          - `name` string, required: Nome do banner.
          - `slug` string, required: Slug do banner.
          - `image_url` string, uri, nullable: URL da imagem do banner para exibição em desktop.
          - `mobile_image_url` string, uri, nullable: URL da imagem do banner para exibição em dispositivos móveis.
          - `link` string, uri, nullable: URL de destino ao clicar no banner.
          - `expired` boolean, required: Indica se o período de exibição do banner já expirou.
          - `stopwatch` string, nullable: Texto de contagem regressiva exibido no banner, quando configurado.
          - `stopwatch_expires_in` integer, nullable: Tempo restante, em segundos, para o fim da contagem regressiva do banner.
          - `start_at` BaseTimestamp, required: Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.
            - `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.
          - `end_at` BaseTimestamp, required: Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário em que foi registrada.
            - `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.
          - `first_banner` object, required: Dados resumidos do primeiro banner ativo do grupo.
            - `id` integer, required: ID do primeiro banner ativo do grupo.
            - `link` string, uri, nullable: URL de destino ao clicar no primeiro banner do grupo.
            - `image` string, uri, nullable: URL da imagem do primeiro banner do grupo para exibição em desktop.
            - `mobile_image` string, uri, nullable: URL da imagem do primeiro banner do grupo para exibição em dispositivos móveis.
            - `stopwatch` string, nullable: Texto de contagem regressiva exibido no primeiro banner do grupo, quando configurado.
          - `dimensions` object, required: Dimensões recomendadas para as imagens do banner.
            - `desktop` object, required: Dimensões recomendadas para a imagem exibida em desktop.
              - …
            - `mobile` object, required: Dimensões recomendadas para a imagem exibida em dispositivos móveis.
              - …
          - `product` object, required: Produtos vinculados ao banner.
            - `data` ProductBannerPublic[], required: Lista dos produtos vinculados ao banner.
              - …

## Other responses

- `404`: Loja não encontrada

## Changes

- **2026-11-03** `bbafb577e11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/public/catalog/collections/active/get.md)

---

[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)