---
title: "List store affiliates."
method: GET
path: "/stores/{storeId}/affiliates"
tags: ["Affiliate"]
---

# List store affiliates.

`GET /stores/{storeId}/affiliates`

Retrieves affiliates for the specified store using query-based filter options.
Supports filtering, sorting, and pagination via query parameters.
Requires the `stores.affiliates.view` permission.

## Path parameters

- `storeId` string, uuid, required

## Query parameters

- `query` string
- `isEnabled` boolean
- `email` string
- `link` string
- `balanceFrom` number, double
- `balanceTo` number, double
- `returnPercentageFrom` integer
- `returnPercentageTo` integer
- `percentageOffFrom` integer
- `percentageOffTo` integer
- `referredOrdersFrom` integer
- `referredOrdersTo` integer
- `allTimeEarnedFrom` number, double
- `allTimeEarnedTo` number, double
- `payoutCountFrom` integer
- `payoutCountTo` integer
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `Filters` string
- `Sorts` string
- `Page` integer
- `PageSize` integer

## Response `200`

The object was successfully returned.

- DisplayAffiliatePaginatedResponse — Represents a paginated response returned from API endpoints, which contains the paginated data and metadata about the pagination.
  - `success` boolean, required — Indicates whether the operation was successful
  - `pages` integer, required — The total number of pages available in the paginated response.
  - `data` DisplayAffiliate[], required — Represents the collection of items within a paginated response
    - `id` string, uuid, required — The unique identifier of the entity
    - `dateCreated` string, date-time, required — The date the entity was created
    - `isEnabled` boolean, required — Indicates whether the affiliate is enabled.
    - `customerId` string, uuid, required — The ID of the customer associated with the affiliate.
    - `emailAddress` string, required — Represents the email address of the affiliate.
    - `link` string, required — Represents the affiliate's unique referral link.
    - `returnPercentage` integer, nullable — Represents the percentage of returns associated with the affiliate.
    - `percentageOff` integer, nullable — Represents the discount percentage offered.
    - `balance` number, double, required — Represents the current balance associated with the affiliate.
    - `allTimeEarned` number, double, required — Total amount earned by the affiliate over time.
    - `referredOrders` integer, required — Represents the number of orders referred by the affiliate.
    - `conversionRate` number, double, required — Represents the ratio of delivered referred orders to incomplete orders.

---

[API](https://skmtc.net/komerza/apis/komerza-api.md) · [All operations](https://skmtc.net/komerza/apis/komerza-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komerza/komerza-api/revisions/060e78bc7f80/schema)