get
https://{subdomain}.myshoplaza.com/openapi/2025-06/price_rules//discount_codes
Retrieves all discount codes associated with a specific price rule.
Requiresprice_rulesaccess scope. More access scope
The Discount Code List API retrieves a list of all discount codes.
This API is especially useful for:
- Fetching paginated lists of discount codes for review.
- Retrieving details and links for further management of discount codes.
- Validating and auditing discount code data for use.
Request Parameters
Public Request Parameters
Path Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
price_rule_id | string | Yes | Price rule ID | pr_123456 |
Response Explanation
Public Response Parameters
Successful Response
| Parameter | Type | Example | Description |
|---|---|---|---|
code | string | 200 | Error code (200 indicates success) |
message | string | Success | Error message |
data | object | {...} | Contains the price rules data |
data.discount_codes | array of objects | [ {...}, {...} ] | List of discount code objects |
Discount Code Object Structure
| Parameter | Type | Example | Description |
|---|---|---|---|
id | string | dc_123456 | Unique identifier of the discount code |
price_rule_id | string | pr_123456 | ID of the associated price rule |
code | string | SUMMER20 | The actual discount code text |
created_at | string | 2023-06-20T15:30:00Z | Timestamp when the discount code was created |
updated_at | string | 2023-06-21T09:15:00Z | Timestamp when the discount code was last updated |
use_with_other | int32 | 1 | Whether the code can be used with other discounts (1=yes, 0=no) |
usage_count | int32 | 42 | Number of times the discount code has been used |
Error Response
| Field | Type | Example | Description |
|---|---|---|---|
code | string | InvalidParameter | Error http message |
message | string | `` | Error message |