# Consultar estampas (cores/variações)

> Lista as estampas ativas — cores sólidas (hex) e estampas com imagem.

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


## O que faz

Lista as estampas **ativas**. Cada estampa é de um tipo:

| `tipo` | `arquivo` |
|---|---|
| `hex` | A cor em hexadecimal (ex.: `#FF7518`). |
| `jpg` | URL da imagem da estampa (com validade). |
| `null` | Estampa ainda sem imagem. |

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/estampa/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 estampa. |
| `nome` | Nome exato da estampa. |
| `cod_externo` | Código da estampa no ERP. |
| `arquivo` | arquivo=N lista só as estampas ainda sem imagem. |


## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/estampa/consultar/SEU_TOKEN?nome=AZUL%20CLARO"
```

```json
{
  "estampa": [
    { "id": "709", "nome": "AZUL CLARO", "tipo": "hex", "arquivo": "#ADD8E6", "cod_externo": null, "status": "S" }
  ]
}
```

## Pode reenviar?

Sim (somente leitura).
