---
title: "GET /PriceRules"
method: GET
path: "/PriceRules"
tags: ["PriceRules"]
---

# GET /PriceRules

`GET /PriceRules`

## Query parameters

- `isActive` boolean
- `scope` string
- `groupCodeId` string
- `page` union
  - integer
  - string, int32
- `pageSize` union
  - integer
  - string, int32

## Response `200`

OK

- PriceRuleListResponseDto
  - `items` PriceRuleDto[]
    - `id` string
    - `name` string
    - `description` string, nullable
    - `isActive` boolean
    - `displayOrder` union
      - integer
      - string, int32
    - `priority` union
      - integer
      - string, int32
    - `ruleType` string — One of: BuyXGetYFree, BuyXGetYPercentOff, SpendThreshold, QuantityTier.
    - `scope` string — One of: GroupCode, Global.
    - `groupCodeId` string, nullable
    - `validFrom` string, date-time, nullable
    - `validTo` string, date-time, nullable
    - `maxUsageCount` union
      - integer
      - string, int32
    - `usageCount` union
      - integer
      - string, int32
    - `minimumOrderAmount` union
      - number, double
      - string, double
    - `maxDiscountAmount` union
      - number, double
      - string, double
    - `stackingOverride` string, nullable — One of: BestWins, Stack, or null to inherit the tenant setting.
    - `payload` PriceRulePayloadDto — Typed parameters for a price rule; relevant fields depend on RuleType.
      - `buyQuantity` union
        - integer
        - string, int32
      - `getQuantity` union
        - integer
        - string, int32
      - `getDiscountPercent` union
        - number, double
        - string, double
      - `thresholdAmount` union
        - number, double
        - string, double
      - `discountType` string, nullable — "Percentage" or "Fixed" (SpendThreshold only).
      - `discountValue` union
        - number, double
        - string, double
      - `tiers` PriceRuleTierDto[], nullable
        - `minQuantity` union
          - number, double
          - string, double
        - `unitPrice` union
          - number, double
          - string, double
    - `targets` PriceRuleTargetDto[]
      - `id` string, nullable
      - `targetKind` string — One of: CatalogItem, Category, GroupCodeMembership, AnyLineItem, InventoryItemTag.
      - `role` string — One of: Qualifying, Reward.
      - `serviceCatalogItemId` string, nullable
      - `retailItemId` string, nullable
      - `inventoryItemId` string, nullable
      - `category` string, nullable
      - `tagId` string, nullable — Set when TargetKind is InventoryItemTag — the inventory-item Smart Tag id.
    - `clientTagIds` string[] — Customer-tag ids that gate this rule. Empty = applies to any client; when non-empty the rule fires only for clients carrying at least one of them.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `total` union
    - integer
    - string, int32

---

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