get
https://{subdomain}.myshoplaza.com/openapi/2025-06/discount_codes/lookup
Allows you to find a specific discount code by providing its code.
Requiresprice_rulesaccess scope. More access scope
The Search Discount Code API allows you to find a specific discount code by providing its code.
This API is especially useful for:
- Retrieving detailed information about a specific discount code.
- Verifying if a discount code exists in the system.
- Fetching metadata and usage statistics for a specific discount code.
Request Parameters
Public Request Parameters
Query Parameters
| Field | Type | Required | Example | Description |
|---|---|---|---|---|
code | string | Yes | "SUMMERSALE100FF" | The unique discount code to be searched for. |
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_code | object | {...} | discount code object |
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 |