# Consultar vendedores

> Lista vendedores e representantes da loja, para vincular clientes.

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


## O que faz

Sem filtro, lista os usuários com cargo **Vendedor** ou **Representante Externo**.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/vendedores/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 vendedor (texto codificado). |
| `email` | E-mail do vendedor. |
| `whatsapp` | WhatsApp do vendedor. |


## Exemplo

```json
{
  "retorno": true,
  "vendedores": [
    { "id": "MQ", "nome": "Ana", "email": "vendedora@loja.com.br", "whatsapp": "(35) 99999-0000", "cargo": "Vendedor" }
  ]
}
```

O `id` é um texto codificado; use como recebido em `cliente/cadastrar` (`"vendedor": {"id": "MQ"}`).

## Pode reenviar?

Sim (somente leitura).
