Skip to main content

Get Price Rules

GET /v2/price-rule

Retrieves a list of price rules defined under the current tenant. Each rule specifies conditions for discounts or pricing adjustments applied to products, customers, or collections. Supports filtering by active state and includes pagination metadata.

Response Example

{
"priceRules": [
{
"_id": "price-rule-id-1",
"name": "Best customer discount",
"tenant": "tenant-id-1",
"type": "discount",
"productIDs": [],
"customerIDs": ["customer-id-1"],
"productCollectionIDs": [],
"customerCollectionIDs": [],
"active": true,
"allowStacking": false,
"percentage": 10,
"deleted": null,
"priceRange": [],
"created": "2025-10-02T19:04:47.611Z",
"updated": "2025-10-02T19:04:47.611Z",
"id": "price-rule-id-1"
},
{
"dateRange": {
"from": "2025-06-19T22:00:00.000Z",
"to": "2025-06-26T22:00:00.000Z"
},
"_id": "price-rule-id-2",
"name": "Apple campaign",
"tenant": "tenant-id-1",
"type": "discount",
"productIDs": [
"product-id-1",
"product-id-2",
"product-id-3"
],
"customerIDs": [
"customer-id-1",
"customer-id-2"
],
"productCollectionIDs": [],
"customerCollectionIDs": [],
"active": true,
"allowStacking": false,
"percentage": 20,
"deleted": null,
"priceRange": [],
"created": "2025-10-02T19:04:47.602Z",
"updated": "2025-10-02T19:04:47.602Z",
"id": "price-rule-id-2"
}
],
"metadata": {
"totalCount": 2,
"page": 0,
"perPage": 25
}
}