Retrieve price rules list

Requires read_discounts access scope.

For more info , refer to:

[]

access permission

GET https://{handle}.myshopline.com/admin/openapi/v20250601/sales/price_rules.json

[]

handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .

[]

Query Price Rule In Pages

Query Parameters

created_at_max string
[]
Return objects created some time ago
[]
Example: 2023-07-11T09:00:00+08:00
created_at_min string
[]
Returns objects created after a certain time
[]
Example: 2023-07-10T09:00:00+08:00
ends_at_max string
[]
A preferential rule that returns money whose end time is at a certain time
[]
Example: 2023-07-11T09:00:00+08:00
ends_at_min string
[]
Returns offer rules with an end time after a certain time
[]
Example: 2023-07-10T09:00:00+08:00
limit string
[]
The number of queries is limited, the default is 50, and it cannot exceed 1000
[]
Example: 50
page_info string
[]
Paging information, can be used with limit, but is mutually exclusive with other conditions
since_id string
[]
Returns the object "after" a certain ID
[]
Example: 6018703339935504723
starts_at_max string
[]
Returns discount rules with start time before a certain time
[]
Example: 2023-07-11T09:00:00+08:00
starts_at_min string
[]
Returns discount rules with start time after a certain time
[]
Example: 2023-07-10T09:00:00+08:00
times_used integer
[]
Show the price rule with this value
[]
Example: 3
update_at_max string
[]
Returns objects updated before a certain time
[]
Example: 2023-07-11T09:00:00+08:00
update_at_min string
[]
Returns an object updated after a certain time
[]
Example: 2023-07-10T09:00:00+08:00

Request Headers

Content-Type required
[]
The value of this field is fixed to application/json; charset=utf-8
Authorization string required
[]
The access token for the API. Please refer to App authorization to obtain the access token, and then put the obtained access token into the API request header in Bearer Token.
Example:
[]
Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw

Response

[]

For more information about status codes, see Http status code.

Response Headers

link
[]
link up and down
traceId
[]
traceId

Response Body

price_rulesobject[]
[]
Discount rules
allocation_limit string
[]
When you buy X and get Y, you can accumulatively distribute the limit of discounts in the shopping cart if you meet the conditions. For example: if you buy 1 X and get 1 Y discount, set allocation_limit=2, when there are 3 X products in the shopping cart, When there are 3 Y items, only 2 Y items can be obtained
[]
Example: 2
allocation_method string
[]
The distribution method of the price rule, the acceptable values are ● each The discount is applied to each participating product. For example, for a $15 off price rule, each eligible item will be $15 off at checkout, for a total of $15 multiplied by the number of items. ● The discount amount calculated across will be applied to the entire eligible listing. For example, for a $15 off price rule, the discount will be spread across each participating item, for a total of $15 off. When the target_type value is shipping_line, allocation_method must be each. The default is across
[]
Example: across
create_at string
[]
Creation time
[]
Example: 2023-07-10T11:00:00+08:00
ends_at string
[]
End time ● The default value is empty ● If it is not filled, it will be regarded as no end time, and the promotion rules are indefinite ● The date processing method is the same as above
[]
Example: 2023-08-10T11:00:00+08:00
entitled_collection_ids array
[]
Specify an array of category ids ● If target_selection is entitled, one of the three options entitled_product_ids, entitled_collection_ids, and entitled_variant_ids must have a value ● The three fields entitled_product_ids, entitled_collection_ids, and entitled_variant_ids are mutually exclusive, and only one field can have a value
[]
Example: 12259764246208273857373144
entitled_country_ids array
[]
Multiple country/region ids are acceptable
[]
Example: "HK","TW","SG"
entitled_product_ids array
[]
Specify the product id array ● If target_selection is entitled, one of the three options entitled_product_ids, entitled_collection_ids, and entitled_variant_ids must have a value ● The three fields entitled_product_ids, entitled_collection_ids, and entitled_variant_ids are mutually exclusive, and only one field can have a value. When you buy X and get Y, it means Y Product ID list
[]
Example: 16059766321245219059003144
entitled_variant_idsobject[]
[]
Designated style array ● If target_selection is entitled, one of entitled_product_ids, entitled_collection_ids, and entitled_variant_ids must have a value ● The three fields entitled_product_ids, entitled_collection_ids, and entitled_variant_ids are mutually exclusive, and only one field can have a value ● When you buy X and get Y, it means Y product Style list
product_id string
[]
Product ID
[]
Example: 16059766321245219059003144
variant_id string
[]
variant_id
[]
Example: 18059766321249077818743144
id string
[]
price rule id
[]
Example: 6018695669979551970
joint_discount boolean
[]
Overlay Offer ● The default value is false
joint_discount_order boolean
[]
Superimposed discounts - automatic discounts - order discounts
[]
Example: true
joint_discount_product boolean
[]
Superimposed discounts-automatic discounts-commodity discounts
[]
Example: true
joint_discount_shipping boolean
[]
Overlay Offer - Automatic Offer - Shipping Discount
[]
Example: true
overlay_discount_code boolean
[]
Superimposed discounts-discount code discounts, allowing multiple discount code activities to stack discounts
overlay_discount_code_order boolean
[]
Superimposed discounts-discount code discounts, allowing multiple discount code activities to be used in superimposed discounts. order discount
[]
Example: true
overlay_discount_code_product boolean
[]
Superimposed discounts-discount code discounts, allowing multiple discount code activities to be used in superimposed discounts. Product discount
[]
Example: true
overlay_discount_code_shipping boolean
[]
Superimposed discounts-discount code discounts, allowing multiple discount code activities to be used in superimposed discounts. shipping discount
[]
Example: true
prerequisite_collection_ids array
[]
When buying X to get Y, the category Id list of X product cannot be used at the same time with prerequisite_product_ids and prerequisite_variant_ids
[]
Example: 12259764246208273857373144
prerequisite_customer_ids array
[]
Specified Customer Prerequisite: Customer must belong to one of the searches saved by the specified customer (customer group) requisite_saved_search_ids, or one of the customers specified by requisite_customer_ids.
[]
Example: ``
prerequisite_product_ids array
[]
When buying X to get Y, when buying X to get Y, the X product Id list, and prerequisite_collection_ids, prerequisite_variant_ids will not be used at the same time
[]
Example: 16059766321245219059003144
prerequisite_quantity_rangeobject
[]
Promotion triggers the minimum quantity of items ● prerequisite_quantity_range and prerequisite_subtotal_range are mutually exclusive ● If both are empty, it is the trigger condition for no price or quantity
greater_than_or_equal_to integer
[]
● nullable ● must be >0 ● only integers are acceptable (integer)
[]
Example: 5
prerequisite_saved_search_ids array
[]
Specify customer group Prerequisite: Customer must belong to one of the customer saved searches specified by (customer group) requisite_saved_search_ids, or one of the customers specified by requisite_customer_ids.
[]
Example: ``
prerequisite_shipping_price_rangeobject
[]
Shipping must be less than or equal to this value. * Not required, default is empty. * 1) The content can only be filled in under target_type=shipping_line * 2) The value and accuracy are consistent with the corresponding accuracy of the store currency
less_than_or_equal_to string
[]
Shipping must be less than or equal to this value. * Not required, default is empty. * 1) The content can only be filled in under target_type=shipping_line 2) The value and accuracy are consistent with the corresponding accuracy of the store currency
[]
Example: 50
prerequisite_subtotal_rangeobject
[]
Promotion triggers the minimum order amount ● prerequisite_quantity_range and prerequisite_subtotal_range are mutually exclusive ● If both are empty, it is the trigger condition for no price or quantity
greater_than_or_equal_to string
[]
● Can be null ● Rounded to two decimal places Example: ● If 11.116666 is passed in, it will be processed as 11.12
[]
Example: 100
prerequisite_to_entitlement_purchaseobject
[]
When buying X to get Y, the amount threshold that X product needs to meet
prerequisite_amount string
[]
The amount threshold required by product X cannot be used with prerequisite_quantity at the same time
[]
Example: 100
prerequisite_to_entitlement_quantity_ratioobject
[]
When buying X to get Y, the quantity threshold required for X product and the quantity of Y product obtained
entitled_quantity integer
[]
The number of Y products obtained when the threshold is met once
[]
Example: 1
prerequisite_quantity integer
[]
The quantity of X goods required to meet the 1 threshold, cannot be used together with prerequisite_quantity
[]
Example: 1
prerequisite_variant_idsobject[]
[]
When buying X to get Y, the style id list of X product will not be used together with prerequisite_product_ids and prerequisite_collection_ids
product_id string
[]
Product ID
[]
Example: 16059766321245219059003144
variant_id string
[]
style id
[]
Example: 18059766321249077818743144
sales_channels array
[]
If the sales channel is not transmitted by default, it means that all channels are available; If a specified sales channel is uploaded, it is available only in that channel
[]
Example: web
starts_at string
[]
● Use the ISO 8601 time format, and the standard format is ○ 2021-10-20T09:59:10+08:00 ● If no time zone value is passed, it will be regarded as GMT standard time
[]
Example: 2023-07-10T11:00:00+08:00
target_selection string
[]
The scope of application of preferential rules, the acceptable values are ● all, defined as all products; ● entitled, defined as specified range (specified product/specified category). When this field obtains the value of entitled, one of entitled_product_ids and entitled_collection_ids must be selected. Value; when target_type=shipping_line, all must be filled. The default value is all
[]
Example: all
target_type string
[]
The target type to which the price rule applies. Valid values: line_item: The price rule to apply to the shopping line item item. shipping_line: The price rule applies to the shopping order shipping line.
[]
Example: line_itme
title string
[]
The name of the discount rules
[]
Example: This is title of price rule
update_at string
[]
Update time
[]
Example: 2023-07-10T11:00:00+08:00
usage_limit integer
[]
Limit the total number of uses of all discount codes bound to this discount rule ● If not filled, the default value is null or empty, which means unlimited use times ● Only empty and natural numbers are acceptable; ● If the upper limit value is exceeded, it will be automatically processed as upper limit value
[]
Example: 2
usage_per_customer integer
[]
Limit the number of times each customer can use each code under the price rule ● If not filled, the default value is null or empty, which means unlimited usage ● Only empty and natural numbers are acceptable; ● Values exceeding the upper limit are automatically processed as up limit value
[]
Example: 10
value string
[]
Discount amount or percentage, ● If the value_type value is percentage, it indicates the discount percentage, rounded to an integer, for example: 10% discount, fill in 10; ● If the value_type value is fixed_amount, it indicates the discount amount, the unit is yuan, rounded to two decimal places, For example: If the discount is 10.23 yuan, fill in -10.23. required field
[]
Example: 20
value_type string
[]
Offer type, acceptable values are ● percentage percentage, percentage must be filled in when target_type=shipping_line, and percentage must be filled in for buy x get y type activities; ● fixed_amount fixed amount; required field
[]
Example: percentage

API Explorer

Debugger

Examples

Base URL

https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601

ParamOptions

Authorization — header required

created_at_max — query

created_at_min — query

ends_at_max — query

ends_at_min — query

limit — query

page_info — query

since_id — query

starts_at_max — query

starts_at_min — query

times_used — query

update_at_max — query

update_at_min — query

Language

curl --request GET \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20250601/sales/price_rules.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'

Was this article helpful to you?

SHOPLINE

Legal