# Consultar coleções

> Lista as coleções da loja; por padrão só as ativas.

Fonte: https://api.viashopmoda.com.br/docs-api/?p=recursos/colecao/consultar · Atualizado em 18/11/2026


## O que faz

Lista as coleções. Sem `status=todas`, só as **ativas** aparecem.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/colecao/consultar/{TOKEN}` |
| **Corpo** | Nenhum. Filtros vão na query string (`?campo=valor&...`). |
| **Token** | Substitua `{TOKEN}` pelo token da loja. Ele vai no caminho da URL, não em cabeçalho. |


## Parâmetros

Todos os parâmetros são opcionais e vão na query string. Use um filtro por vez, salvo quando a descrição disser para combinar.

| Parâmetro | Descrição |
|---|---|
| `id` | Id da coleção. |
| `nome` | Nome exato da coleção. |
| `status` | Use status=todas para incluir as coleções inativas. Sem ele, só ativas. |


## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/colecao/consultar/SEU_TOKEN?status=todas"
```

```json
{
  "colecao": [
    { "id": "32", "nome": "INVERNO 2026", "status": "Ativo" },
    { "id": "21", "nome": "VERÃO 2025", "status": "Inativo" }
  ]
}
```

## Pode reenviar?

Sim (somente leitura).
