# Get a list of user coupons
# Instructions for Interface Calls
http请求方式：POST
https://api.weixin.qq.com/shop/coupon/get_usercoupon_list?access_token=xxxxxxxxx
# Example of request parameters
{
"page_size": 2,
"offset": 1,
"openid": "oIJ9d5Ad4JMhbybqJ3_J73LkR_Io"
}
# Examples of back-up
{
"errcode": 0,
"total_num": 3,
"result_list": [{
"out_user_coupon_id": "out_user_coupon_id_1",
"openid": "oIJ9d5Ad4JMhbybqJ3_J73LkR_Io",
"out_coupon_id": "coupon_id_1",
"status": 100,
"create_time": 1625474308,
"update_time": 1625474308,
"end_time": 1625464250,
"ext_info": {},
"start_time": 1625451250
}, {
"out_user_coupon_id": "out_user_coupon_id_2",
"openid": "oIJ9d5Ad4JMhbybqJ3_J73LkR_Io",
"out_coupon_id": "out_coupon_id_3",
"status": 102,
"create_time": 1625237877,
"update_time": 1625237997,
"end_time": 0,
"ext_info": {
"use_time": 1625237997
},
"start_time": 0
}]
}
# Dxplaination of request parameters
| 参数 | type | Is it compulsory? | Introductions |
|---|---|---|---|
| page_size | number | yes | Page size, maximum 200 |
| offset | number | no | The amount of variation, starting with 0 |
# Dxplaination of callback parameters
| 参数 | type | Introductions |
|---|---|---|
| total_num | number | total |
| result_list.out_user_coupon_id | string | Merchant Side User Coupon ID |
| result_list.openid | string | openid |
| result_list.out_coupon_id | string | Merchant Side Coupon ID |
| result_list.status | number | User Coupon Status |
| result_list.create_time | number | User coupon creation time (second time stamp) |
| result_list.update_time | number | User coupon update time (second time stamp) |
| result_list.start_time | number | Duration of validity of user coupons (second time stamp) |
| result_list.end_time | number | User coupon expiration time (second time stamp) |
| result_list.ext_info.use_time | number | Write-off time (second timestamp) |