List blocked users

Returns the WhatsApp phone numbers currently blocked from messaging the app, with cursor-based pagination via the limit and after parameters.

Request parameters

Path parameters

KeyDescriptionValuesData TypeRequired/Optional
appIdIdentifier of the WhatsApp app the call acts on.6f414190-d45c-4671-bca1-fb6c3018cb13StringRequired

Query parameters

KeyDescriptionValuesData TypeRequired/Optional
limitMaximum number of records to return in one page.20IntegerOptional
afterCursor returned by a previous page; fetches the records after it.—StringOptional

Sample cURL — List blocked users.

curl --request GET \
  --url 'https://partner.gupshup.io/partner/bizgate/app/6f414190-d45c-4671-bca1-fb6c3018cb13/access/users/blocked?limit=20' \
  --header 'Authorization: Bearer <UT>' \
  --header 'Accept: application/json'

Sample success response (200)

{
  "status": "success",
  "data": {
    "users": [
      {
        "phone": "91XXXXXXXX10",
        "blocked": true
      },
      {
        "phone": "91XXXXXXXX78",
        "blocked": true
      }
    ]
  }
}
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Identifier of the WhatsApp app the call acts on.

Query Params
int32

Maximum number of records to return in one page.

string

Cursor returned by a previous page; fetches the records after it.

Responses

Language
Credentials
Bearer
Universal Token (UT)
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json