v2.account_health.get_penalty_point_history
GET /api/v2/account_health/get_penalty_point_history
Get the penalty point records generated in the current quarter.
Endpoint URL
URL: https://partner.shopeemobile.com/api/v2/account_health/get_penalty_point_history
Common Request Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| partner_id | int | 1 | Partner ID is assigned upon registration is successful. Required for all requests. |
| timestamp | timestamp | 1610000000 | This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes. |
| access_token | string | c09222e3fc40ffb25fc947f738b1abf1 | The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours. |
| shop_id | int | 600000 | Shopee's unique identifier for a shop. Required param for most APIs. |
| sign | string | e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2 | Signature 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
| Name | Type | Required | Sample | Description |
|---|---|---|---|---|
| page_no | int32 | False | 1 | Specifies the page number of data to return in the current call. Starting from 1. if data is more than one page, the page_no can be some entry to start next call. Default is 1. |
| page_size | int32 | False | 10 | Each result set is returned as a page of entries. Use the "page_size" filters to control the maximum number of entries to retrieve per page (i.e., per call), and the "page_no" to start next call. This integer value is used to specify the maximum number of entries to return in a single "page" of data. The limit of page_size if between 1 and 100. Default is 10. |
| violation_type | int64 | False | 5 | Applicable values: 5: High Late Shipment Rate 6: High Non-fulfilment Rate 7: High number of non-fulfilled orders 8: High number of late shipped orders 9: Prohibited Listings 10: Counterfeit / IP infringement 11: Spam 12: Copy/Steal images 13: Re-uploading deleted listings with no change 14: Bought counterfeit from mall 15: Counterfeit caught by Shopee 16: High percentage of pre-order listings 17: Confirmed Fraud attempts (total) 18: Confirmed Fraud attempts per week (All with vouchers only) 19: Fake return address 20: Shipping fraud/abuse 21: High No. of Non-responded Chat 22: Rude chat replies 23: Request buyer to cancel order 24: Rude reply to buyer's review 25: Violate Return/Refund policy 101: Tier Reason 3026: Misuse of Shopee’s IP 3028: Violate Shop Name Regulations 3030: Direct transactions outside of the Shopee platform 3032: Shipping empty / incomplete parcels 3034: Severe Violations on Shopee Feed 3036: Severe Violations on Shopee LIVE 3038: Misuse of Local Vendor Tag 3040: Use of misleading shop tag in listing image 3042: Counterfeit / IP Infringement test 3044: Repeat Offender - IP infringement and Counterfeit listings 3046: Violation of Live Animals Selling Policy 3048: Chat Spam 3050: High Overseas Return Refunds Rate 3052: Privacy breach in buyer's review reply 3054: Order Brushing 3056: porn image 3058: Incorrect Product Categories 3060: Extremely High Non-Fulfilment Rate 3062: Penalty of Affiliate Marketing Solution (AMS) Overdue Invoice Payment 3064: Government-related listing 3066: Listing invalid gifted items 3068: High non-fulfilment rate (Next Day Delivery Orders) 3070: High Late Shipment Rate (Next Day Delivery Orders) 3072: OPFR Violation Value 3074: Direct transactions outside Shopee platform via chat 3090: Prohibited Listings-Extreme Violations 3091: Prohibited Listings-High Violations 3092: Prohibited Listings-Mid Violations 3093: Prohibited Listings-Low Violations 3094: Counterfeit Listings-Extreme Violations 3095: Counterfeit Listings-High Violations 3096: Counterfeit Listings-Mid Violations 3097: Counterfeit Listings-Low Violations 3098: Spam Listings-Extreme Violations 3099: Spam Listings-High Violations 3100: Spam Listings-Mid Violations 3101: Spam Listings-Low Violations 3145: Return/Refund Rate (Non-integrated Channel) 4130: Poor Product Quality |
Response Parameters
| Name | Type | Sample | Description |
|---|---|---|---|
| error | string | Indicate error type if hit error. Empty if no error happened. | |
| message | string | Indicate error details if hit error. Empty if no error happened. | |
| request_id | string | The identifier for an API request for error tracking. | |
| response | object | ||
| penalty_point_list | object[] | The penalty point records generated in the current quarter. | |
| issue_time | timestamp | 1728552398 | The time when penalty points are issued. |
| latest_point_num | int32 | 0 | The latest penalty points issued under current penalty point record. If seller raised appeal for this penalty point record and the appeal has been approved and Shopee adjusted the penalty point, then the original_point_num returns the penalty point before the adjustment, and latest_point_num returns the penalty point after the adjustment. |
| original_point_num | int32 | 1 | The original penalty points issued under current penalty point record. If seller raised appeal for this penalty point record and the appeal has been approved and Shopee adjusted the penalty point, then the original_point_num returns the penalty point before the adjustment, and latest_point_num returns the penalty point after the adjustment. |
| reference_id | int64 | 764539404640322244 | Reference ID for this penalty point record. |
| violation_type | int32 | 5 | Applicable values: 5: High Late Shipment Rate 6: High Non-fulfilment Rate 7: High number of non-fulfilled orders 8: High number of late shipped orders 9: Prohibited Listings 10: Counterfeit / IP infringement 11: Spam 12: Copy/Steal images 13: Re-uploading deleted listings with no change 14: Bought counterfeit from mall 15: Counterfeit caught by Shopee 16: High percentage of pre-order listings 17: Confirmed Fraud attempts (total) 18: Confirmed Fraud attempts per week (All with vouchers only) 19: Fake return address 20: Shipping fraud/abuse 21: High No. of Non-responded Chat 22: Rude chat replies 23: Request buyer to cancel order 24: Rude reply to buyer's review 25: Violate Return/Refund policy 101: Tier Reason 3026: Misuse of Shopee’s IP 3028: Violate Shop Name Regulations 3030: Direct transactions outside of the Shopee platform 3032: Shipping empty / incomplete parcels 3034: Severe Violations on Shopee Feed 3036: Severe Violations on Shopee LIVE 3038: Misuse of Local Vendor Tag 3040: Use of misleading shop tag in listing image 3042: Counterfeit / IP Infringement test 3044: Repeat Offender - IP infringement and Counterfeit listings 3046: Violation of Live Animals Selling Policy 3048: Chat Spam 3050: High Overseas Return Refunds Rate 3052: Privacy breach in buyer's review reply 3054: Order Brushing 3056: porn image 3058: Incorrect Product Categories 3060: Extremely High Non-Fulfilment Rate 3062: Penalty of Affiliate Marketing Solution (AMS) Overdue Invoice Payment 3064: Government-related listing 3066: Listing invalid gifted items 3068: High non-fulfilment rate (Next Day Delivery Orders) 3070: High Late Shipment Rate (Next Day Delivery Orders) 3072: OPFR Violation Value 3074: Direct transactions outside Shopee platform via chat 3090: Prohibited Listings-Extreme Violations 3091: Prohibited Listings-High Violations 3092: Prohibited Listings-Mid Violations 3093: Prohibited Listings-Low Violations 3094: Counterfeit Listings-Extreme Violations 3095: Counterfeit Listings-High Violations 3096: Counterfeit Listings-Mid Violations 3097: Counterfeit Listings-Low Violations 3098: Spam Listings-Extreme Violations 3099: Spam Listings-High Violations 3100: Spam Listings-Mid Violations 3101: Spam Listings-Low Violations 3145: Return/Refund Rate (Non-integrated Channel) 4130: Poor Product Quality |
| total_count | int32 | 8 | Total number of penalty point records. |