Get List of Blocked Users

Description

This API allows you to retrieve a paginated list of WhatsApp users blocked by your business account. It is useful for:

  • Auditing user blocks
  • Building admin tools
  • Monitoring abusive activity patterns

Endpoints

GET {{api_front_url}}/wa/app/{{appId}}/user/blocklist?limit={{limit}}&after={{after}}

cURL Request

curl --location --globoff '{{api_front_url}}/wa/app/{{appId}}/user/blocklist?limit={{limit}}&after={{after}}' \
--header 'apikey: {{api_key}}''

Request Parameters

KeyDescriptionConstraints
Headers
apikeyApikey of appShould be a valid gupshup.io apikey
Path Params
appIdappId of the appShould be a valid appId
Query Params
limitLimits the number of blocked users returned in the response.- it's optional - default value is 100 if not specified - maximum value is 100
afterSpecifies the starting point for the next set of results. (Next page)- it's optional - the value of this field is present in the response of the get request