# Consultar grades (tamanhos)

> Lista os tamanhos cadastrados, com descrição e código do ERP.

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


## O que faz

Lista as grades (tamanhos), na ordem configurada na loja.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/grade/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 grade. |
| `nome` | Nome exato da grade (ex.: P). |
| `cod_externo` | Código da grade no ERP. |
| `kit` | kit=S lista só as grades do tipo kit. |


## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/grade/consultar/SEU_TOKEN"
```

```json
{
  "grade": [
    { "id": "14", "grade": "P", "info": "", "is_kit": "N", "cod_externo": null },
    { "id": "17", "grade": "GG", "info": "Extra grande", "is_kit": "N", "cod_externo": "T-GG" }
  ]
}
```

Atenção: o nome do tamanho vem no campo `grade` (não em `nome`), e a descrição em `info`. `is_kit` = `"S"` para grades do tipo kit.

## Pode reenviar?

Sim (somente leitura).
