List discount rebates

GET 
/openapi/2025-06/discount_rebates

Retrieves a list of rebate discounts available for a shop.

Request

Query Parameters

cursor string

Cursor for pagination, use the cursor from the response to retrieve the next page

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

rebates object[]

List of rebates

Array [

allocation_limitint32

Allocation limit

allocation_limit_amountfloat

Allocation limit amount

allocation_methodstring

Allocation method

customer_selectionstring

Customer selection criteria

detail_urlstring

Detail page URL

discount_typestring

Discount type

ends_atstring

End timestamp

entitled_filter_idsstring[]

Entitled filter IDs

entitled_filter_liststring[]

List of entitled filters

entitled_product_idsstring[]

Entitled product IDs

global_show_textstring

Global show text

idstring

Discount ID

once_per_customerint32

Whether usable once per customer

popups_idstring

Popup ID

popups_settingstring

Popup settings

prerequisiteint32

Prerequisite condition

prerequisite_customer_idsstring[]

List of prerequisite customer IDs

prerequisite_customer_rangestring

Customer prerequisite range

prerequisite_customer_segment_idsstring[]

Customer segment prerequisite IDs

prerequisite_quantity_range object[]

Quantity prerequisite range

Array [

greater_than_or_equal_tostring

Greater than or equal to value

valuestring

The value

value_percentagestring

Percentage value

value_event_typestring

Value event type

value_conditionstring

Value condition

target_typestring

Target type

target_datastring[]

Target data

]

prerequisite_subtotal_range object[]

Subtotal prerequisite range

Array [

greater_than_or_equal_tostring

Greater than or equal to value

valuestring

The value

value_percentagestring

Percentage value

value_event_typestring

Value event type

value_conditionstring

Value condition

target_typestring

Target type

target_datastring[]

Target data

]

prerequisite_threshold_quantity_rangestring

Threshold quantity range

prerequisite_threshold_subtotal_rangestring

Threshold subtotal range

product_numint32

Number of products

progressstring

Progress

sortstring

Sort configuration

starts_atstring

Start timestamp

target_price_typestring

Target price type

target_selectionstring

Target selection

target_typestring

Target type

times_usedint32

Number of times used

titlestring

Title

usage_limitint32

Usage limit. -1 means unlimited

valuefloat

The value

value_typestring

Value type

variant_product_idsstring[]

Product IDs of variants

discount_channel_list object[]

List of discount channels

Array [

channel_typestring

Type of channel

channel_statusint32

Status of channel

location_idsstring[]

List of location IDs

]

entitled_area_list object[]

List of entitled areas

Array [

country_codestring

Country code (e.g., CN)

province_codesstring[]

List of province codes

]

entitled_collection_idsstring[]

Entitled collection IDs

entitled_variant_idsstring[]

Entitled variant IDs

statusstring

Status

entitled_extra_list object[]

List of extra entitled items

Array [

idstring

ID

sortint32

Sort configuration

]

]

cursorstring

Cursor for pagination

has_moreboolean

Whether there are more records

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "rebates": [
      {
        "allocation_limit": 0,
        "allocation_limit_amount": 0,
        "allocation_method": "string",
        "customer_selection": "string",
        "detail_url": "string",
        "discount_type": "string",
        "ends_at": "string",
        "entitled_filter_ids": [
          "string"
        ],
        "entitled_filter_list": [
          "string"
        ],
        "entitled_product_ids": [
          "string"
        ],
        "global_show_text": "string",
        "id": "string",
        "once_per_customer": 0,
        "popups_id": "string",
        "popups_setting": "string",
        "prerequisite": 0,
        "prerequisite_customer_ids": [
          "string"
        ],
        "prerequisite_customer_range": "string",
        "prerequisite_customer_segment_ids": [
          "string"
        ],
        "prerequisite_quantity_range": [
          {
            "greater_than_or_equal_to": "string",
            "value": "string",
            "value_percentage": "string",
            "value_event_type": "string",
            "value_condition": "string",
            "target_type": "string",
            "target_data": [
              "string"
            ]
          }
        ],
        "prerequisite_subtotal_range": [
          {
            "greater_than_or_equal_to": "string",
            "value": "string",
            "value_percentage": "string",
            "value_event_type": "string",
            "value_condition": "string",
            "target_type": "string",
            "target_data": [
              "string"
            ]
          }
        ],
        "prerequisite_threshold_quantity_range": "string",
        "prerequisite_threshold_subtotal_range": "string",
        "product_num": 0,
        "progress": "string",
        "sort": "string",
        "starts_at": "string",
        "target_price_type": "string",
        "target_selection": "string",
        "target_type": "string",
        "times_used": 0,
        "title": "string",
        "usage_limit": 0,
        "value": 0,
        "value_type": "string",
        "variant_product_ids": [
          "string"
        ],
        "discount_channel_list": [
          {
            "channel_type": "string",
            "channel_status": 0,
            "location_ids": [
              "string"
            ]
          }
        ],
        "entitled_area_list": [
          {
            "country_code": "string",
            "province_codes": [
              "string"
            ]
          }
        ],
        "entitled_collection_ids": [
          "string"
        ],
        "entitled_variant_ids": [
          "string"
        ],
        "status": "string",
        "entitled_extra_list": [
          {
            "id": "string",
            "sort": 0
          }
        ]
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}