# Consultar gêneros (categorias)

> Lista os gêneros da loja (Feminino, Masculino, Infantil…). Na API, gênero = categoria.

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


## O que faz

Lista os **gêneros** — o campo `genero` do produto. A rota se chama `categoria` por motivo histórico (veja o [Glossário](https://api.viashopmoda.com.br/docs-api/?p=glossario&formato=md)).

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/categoria/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 do gênero. |
| `nome` | Nome exato do gênero. Se vierem id e nome, vale o nome. |


## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/categoria/consultar/SEU_TOKEN?nome=FEMININO"
```

```json
{
  "retorno": true,
  "categoria": [
    { "id": "1", "nome": "FEMININO", "seo_title": "", "seo_description": "", "seo_h1": "", "foto": "", "tag": "feminino" }
  ]
}
```

Nada encontrado: `retorno: false`.

## Pode reenviar?

Sim (somente leitura).

## Onde entra no processo

Opcional na carga do catálogo: `produto/cadastrar` aceita o nome do gênero e cria se não existir.
