getBlacklistUsers

This method is used to retrieve the list of blacklist signups for app signup.

Field	Type	Required	Description
`method`	String	Yes	`"getBlacklistUsers"`
`app_id`	String	Yes	Unique identifier for the App to which the user belongs.
`reference`	String	Optional	A unique reference for the request (used for tracking or logging).
`page_size`	Number	Optional	Number of users to retrieve per page (default is 50).
`page_number`	Number	Yes	The page number to retrieve in pagination. Start from `0`

Preconditions for API Functionality

The following tables outline the preconditions that must be met for the API to function correctly. Failure to meet these conditions may result in errors or unexpected behavior.

Preconditions for API permissions

Before performing signup management messages, ensure the following conditions are met:

Action	Required Permission	Description
signup Management	`"Signup Management"`	The API must have the `"Signup Management"` permission to manage both whitelist and blacklist settings.

Response

getBlacklistUsersResponse

✅ On success, the getBlacklistUsersResponse method is returned.

Field	Type	Returned	Description
`method`	String	Yes	`"getBlacklistUsersResponse` `"`
`app_id`	String	Yes	Unique identifier for App.
`signups`	Array of signup	Yes	Array of Blacklist signup objects
`page_number`	Number	Yes	The page number to retrieve in pagination. Returns the next page of results.
`eop`	Boolean	Conditional	End of page: Indicates that the last page has been reached. Returns `true` when there are no more pages to retrieve. Default is `false`
`reference`	String	Optional	Unique identifier echoed from the request.

Request:

Requests

json
{
  "method": "getBlacklistUsers",
  "app_id": "90090684293000559",
  "reference": 111111148,
}

java

api.getBlackList(incomingMsg.getChat().getId());

public void getBlackList(String chatId) {
	GetBlackListOutMessage getBlackListOutMessage = new GetBlackListOutMessage();
	getBlackListOutMessage.setChatId(chatId);
	api.send(getBlackListOutMessage);
}

javascript

api.getBlackList(incomingMsg.chat.id);

Response

json

  
    "method": "getBlacklistUsersResponse",
    "app_id": "90090684293000559",
    "signups": [
            {
                "id": "490",
                "signup_id": "example@email.com",
                "tags": [ "4"]
            }
        ]
    "page_number": 1,
    "eop": true,
    "reference": 111111148
}