Skip to content

List blacklist ​

Lists your blacklist, optionally including the platform-wide blacklist. Orders for blacklisted customers are rejected (40015).

POST/api/open/blocked/user/list

Full URL = your API base URL + this path. The base URL is shown in the merchant console under Developers → API & callbacks.

Request parameters ​

ParameterTypeRequiredDescription
merchantNostringYesMerchant number
isGlobalboolNotrue returns the whole platform blacklist (including entries added by other merchants); default is yours only

Response ​

data is an array:

FieldTypeDescription
blockTypeint1 by name, 2 by ID number prefix
blockedUserNamestringBlocked name
blockedIdCardPrefixstringBlocked ID number prefix
isOwnboolWhether you added it
remarkstringRemark
createdAtstringWhen it was added
json
{
  "code": 0,
  "message": "success",
  "data": [
    { "blockType": 1, "blockedUserName": "Zhang San", "blockedIdCardPrefix": "", "isOwn": true, "remark": "", "createdAt": "2026-10-01 10:00:00" }
  ]
}