List discount flash sales

GET 
/openapi/2025-06/discount_flash_sales

Retrieves a list of flash sale discounts available for a shop.

Request

Query Parameters

cursor string

Cursor for pagination,

page_size int32

A limit on the number of objects to be returned. Ranges from 1 to 250. Default is 10

need_detail_url boolean

If true, returns detail URLs in the response

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

flash_sales object[]

Flash sales

Array [

idstring

Discount ID

titlestring

Title

discount_typestring

Discount type

once_per_customerint32

Whether usable once per customer

starts_atstring

Start timestamp

ends_atstring

End timestamp

statusint32

Status

sortstring

Sort configuration

allocation_methodstring

Allocation method

allow_oversoldstring

Whether overselling is allowed

progressstring

Progress

product_numint32

Number of products

detail_urlstring

Detail page URL

apply_typestring

Apply type

create_sourcestring

Creation source

]

cursorstring

Cursor for pagination

has_moreboolean

Whether there are more records

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "flash_sales": [
      {
        "id": "string",
        "title": "string",
        "discount_type": "string",
        "once_per_customer": 0,
        "starts_at": "string",
        "ends_at": "string",
        "status": 0,
        "sort": "string",
        "allocation_method": "string",
        "allow_oversold": "string",
        "progress": "string",
        "product_num": 0,
        "detail_url": "string",
        "apply_type": "string",
        "create_source": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}