# Consultar leads

> Lista contatos que ainda não são clientes (deixaram e-mail ou WhatsApp), por id, contato ou período.

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


## O que faz

Devolve leads. Sem filtro, traz os leads de **hoje**. Não há paginação.

## Requisição

| | |
|---|---|
| **Método** | `GET` |
| **URL** | `https://api.viashopmoda.com.br/via/leads/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 lead. |
| `email` | E-mail. |
| `whatsapp` | WhatsApp. |
| `data_inicial` | Início do período (aaaa-mm-dd). |
| `data_final` | Fim do período (aaaa-mm-dd). Sem nenhum filtro: leads de hoje. |


## Exemplo

```bash
curl "https://api.viashopmoda.com.br/via/leads/consultar/SEU_TOKEN?data_inicial=2026-11-01&data_final=2026-11-16"
```

```json
{
  "leads": [
    {
      "id": "TVRZASD",
      "nome": "Joana",
      "email": "",
      "whatsapp": "(35) 98888-0101",
      "status_qualificacao": "Qualificado",
      "data_cadastro": "2026-11-11 11:03:33",
      "origem_pagina": "produto",
      "origem_acesso": "Acesso Direto",
      "utm": "feiras -> festlingerie -> standsvirtuais",
      "vendedor_nome": "Ana",
      "vendedor_email": "vendedora@loja.com.br"
    }
  ]
}
```

- Um lead tem e-mail **ou** WhatsApp; o outro vem vazio.
- `status_qualificacao`: `Aguardo`, `Qualificado` ou `Não qualificado` (definido pela vendedora).

## Pode reenviar?

Sim (somente leitura).
