Skip to main content

v2.shop_flash_sale.get_shop_flash_sale_items

GET /api/v2/shop_flash_sale/get_shop_flash_sale_items

get shop flash sale items and item detail

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/shop_flash_sale/get_shop_flash_sale_items

Common Request Parameters

NameTypeSampleDescription
partner_idint1Partner ID is assigned upon registration is successful. Required for all requests.
timestamptimestamp1610000000This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_idint600000Shopee's unique identifier for a shop. Required param for most APIs.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Request Parameters

NameTypeRequiredSampleDescription
flash_sale_idint64True
offsetint64Truemin=0,max=1000
limitint64Truemin=1,max=100

Response Parameters

NameTypeSampleDescription
request_idstringThe identifier for an API request for error tracking.
errorstringIndicate error type if hit error. Empty if no error happened.
messagestringIndicate error details if hit error. Empty if no error happened.
responseobject
total_countint64
modelsobject[]If the item has variation, the infomation of model will be in this field
item_idint64
model_idint64
model_namestring
statusint32the status of model in shop flash sale 0: disable 1: enable 2: delete 4: system_rejected, the model is rejected by system 5: manual_rejected, the model is rejected manually
original_pricefloat
input_promotion_pricefloatpromotion price without tax
promotion_price_with_taxfloatpromotion price with tax
purchase_limitint640 means NO LIMIT
campaign_stockint64
stockint64Active inventory
reject_reasonstringif the status is 4 or 5, this field will show the reason why this model was rejected
unqualified_conditionsobjectif the model doesn't meet a criteria, will show the detail in this field
unqualified_codeint32
unqualified_msgstring
item_infoobject[]
item_idint64
item_namestring
statusint32item status 0: Deleted 1: Normal 2: reviewing 3: banned 4: invalid 5: invalid hide 6: offensive hide 7: auditing 8: normal unlist
imagestringitem image
item_statusint32the status of item in shop flash sale. If the item has variation, this field will be empty 0: disable 1: enable 2: delete 4: system_rejected, the item is rejected by system 5: manual_rejected, the item is rejected manually
original_pricefloatoriginal price of item, if the item has variation, this field will be empty
input_promotion_pricefloatpromotion price without tax of item, if the item has variation, this field will be empty
promotion_price_with_taxfloatpromotion price with tax of item, if the item has no variation, this field will has value
purchase_limitint640 means NO LIMIT purchase limit of item, if the item has variation, this field will be empty
campaign_stockint64campaign stock of item, if the item has no variation, this field will has value
stockint64Active inventory of item, if the item has no variation, this field will has value
reject_reasonstringif the item_status is 4 or 5, this field will show the reason why this item was rejected if the item has variation, this field will be empty
unqualified_conditionsobjectif the item doesn't meet a criteria, will show the detail in this field if the item has variation, this field will be empty
unqualified_codeint32
unqualified_msgstring

No Request Example Set.