# Get a blacklist list for Official Account

Debugging Tools

Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide

Interface English name: getBlacklist

This interface is used to obtain a blacklist of accounts consisting of a string of OpenIDs (encrypted WeChat numbers, each user unique to each Official Account OpenID).

# 1. How to call

# HTTPS calls

POST https://api.weixin.qq.com/cgi-bin/tags/members/getblacklist?access_token=ACCESS_TOKEN

# Cloud Calls

• Call method: officialAccount.user.getBlacklist

• The input and exit parameters are the same as the HTTPS call, which can be called in the cloud call documentation

# Third party invocation

• This interface supports Third Party Platform generation business call.

• The permission set id to which the interface belongs is: 2,100

• When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.

# 2. Request parameters

# Query parametersQuery String parameters

# Request BodyRequest Payload

# 3. Return Parameters

# Response Payload

# Res.dataObject Payload

User data

# 4. Note

1. Pull up to 1000 OpenIDs at a time
2. Meet demand through multiple pullouts
3. Start from the beginning by default when begin_openid is empty

# 5. Code examples

# 5.1 Get a blacklist

Example Requests

{
  "begin_openid": "OPENID1"
}

Return an example

{
  "total": 23000,
  "count": 1000,
  "data": {
    "openid": [
      "OPENID1",
      "OPENID2"
    ]
  },
  "next_openid": "OPENID1000"
}

# 5.2 Examples of Errors

Example Requests

{
  "begin_openid": ""
}

Return an example

{
  "errcode": 40013,
  "errmsg": "invalid appid"
}

# 6. Error code

The following is a list of error codes for this interface, other error codes can refer to General error codes

# 7. Scope of application