---
title: "Listar clientes de uma condição"
method: GET
path: "/api/promotions/{promotionId}/conditions/{conditionPromotionId}/customers"
tags: ["Admin API · Promoções"]
---

# Listar clientes de uma condição

`GET /api/promotions/{promotionId}/conditions/{conditionPromotionId}/customers`

## Request

- Base URL: `https://sualoja.commerce-wake.tech`
- URL: `https://sualoja.commerce-wake.tech/api/promotions/{promotionId}/conditions/{conditionPromotionId}/customers`
- Auth: HTTP bearer

Lista os clientes vinculados a uma condição de clientes específicos já salva. Um `conditionPromotionId`
desatualizado (anterior ao último PUT) retorna lista vazia, não `404`.
            
Permissão: **Cadastro de promoções — visualização**.

## Path parameters

- `promotionId` integer, required
- `conditionPromotionId` integer, required

## Query parameters

- `Search` string
- `Page` integer
- `Limit` integer

## Headers

- `x-api-version` '2.0', required

## Response `200`

Página de clientes.

- ListingResponseDTOGetCustomersOfAPromotionConditionQueryDTO
  - `data` GetCustomersOfAPromotionConditionQueryDTO[], nullable: Itens da página.
    - `customerId` integer: ID do cliente.
    - `name` string, nullable: Nome do cliente.
    - `email` string, nullable: E-mail do cliente.
  - `total` integer, nullable: Total informado pela listagem. Nas rotas de apoio de promoções é a quantidade de itens desta página; o total geral fica em `totalGeneral`.
  - `totalGeneral` integer, nullable: Total de itens que atendem aos filtros, em todas as páginas.
  - `totalActive` integer, nullable: Total de itens ativos, quando a listagem informa.
  - `totalInactive` integer, nullable: Total de itens inativos, quando a listagem informa.
  - `totalArchived` integer, nullable: Total de itens arquivados, quando a listagem informa.
  - `limit` integer, nullable: Tamanho de página usado.
  - `page` integer, nullable: Página retornada, começando em 1.
  - `totalPage` integer, nullable: Quantidade de páginas, quando a listagem informa.
  - `message` string, nullable: Observação opcional sobre a listagem (por exemplo, por que veio vazia). Omitida quando nula.

## Other responses

- `400`: Requisição inválida, incluindo a falta do header x-api-version. O motivo vem em details.
- `401`: Token ausente, inválido ou expirado (SESSION_INVALID), ou sem a permissão exigida (UNAUTHORIZED).
- `500`: Erro inesperado. Tente de novo; se persistir, contate o suporte com o traceId.

---

[API](https://skmtc.dev/fbits/apis/admin-api.md) - [All operations](https://skmtc.dev/fbits/apis/admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fbits/apis/admin-api/revisions/a37bfd1b0bf3?raw)