> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selltrust.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Campanhas

Lista as campanhas da loja, da mais recente para a mais antiga, com contagens e resultados. O HTML não vem na listagem; use [Obter Campanha](https://docs.selltrust.com.br/api-reference/campaigns/get.md).

> [!NOTE]
>
> Exige a permissão **Gerenciar Marketing** (`MANAGE_MARKETING`) do usuário que criou o token. Veja [Permissões do token](https://docs.selltrust.com.br/api-reference/permissions.md).

**Authorization** `string` *required*

Token de API no formato `Bearer stk_live_...`.

**page** `number`

Página. Padrão: `1`.

**limit** `number`

Itens por página (máximo de 100). Padrão: `10`.

**search** `string`

Filtra pelo nome.

**status** `string`

`DRAFT`, `SCHEDULED`, `SENDING`, `SENT` ou `CANCELED`.

```json Response theme={null}
{
  "data": [
    {
      "id": "uuid-da-campanha",
      "store_id": "uuid-da-loja",
      "name": "Lançamento de novembro",
      "subject": "Novidades para você, {{ customer.first_name }}",
      "audience": {
        "match": "ALL",
        "rules": [
          {
            "type": "PURCHASED_LAST_DAYS",
            "days": 30
          },
          {
            "type": "TOTAL_SPENT",
            "operator": "GT",
            "value": 300
          }
        ]
      },
      "status": "SENT",
      "scheduled_at": null,
      "started_at": "2026-11-10T15:00:00.000Z",
      "finished_at": "2026-11-10T15:04:00.000Z",
      "canceled_at": null,
      "total_recipients": 128,
      "sent_count": 126,
      "failed_count": 1,
      "skipped_count": 1,
      "error": null,
      "created_by": "uuid-do-usuario",
      "created_at": "2026-11-10T14:30:00.000Z",
      "updated_at": "2026-11-10T14:30:00.000Z",
      "pending_count": 0,
      "attributed_orders": 7,
      "attributed_revenue": 913.3
    }
  ],
  "meta": {
    "total": 1,
    "last_page": 1,
    "current_page": 1,
    "per_page": 10,
    "prev": null,
    "next": null
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.