blacklist
List team-wide blacklisted numbers
Retrieves the phone numbers on your team's shared blacklist. The team blacklist applies to all users — calls from blacklisted numbers are blocked for the entire team. This is distinct from per-user blacklists (GET /users/{userId}/blacklists/numbers). Results are paginated using limit_count and limit_offset.
Permission: Numbers Read required.
Monitoring: Required. The team blacklist is a supervisory feature. Returns 401 Unauthorized if Monitoring is OFF on your API key.
get/blacklists/numbers
Query parameters
limit_countinteger
The number of results (default: 100).
limit_offsetinteger
Number of elements that will be ignored (default: 0).
Response
Successful operation — returns the blacklisted numbers.
Example response
{
"team_id": 123456,
"limit_offset_setted": 1,
"limit_count_setted": 10,
"total_blacklist_count": 37,
"blacklist_list_count": 1,
"blacklist_list": [
{
"user_id": 12345,
"team_id": 123456,
"number": 33184800000,
"comment": "Unfriendly",
"direction": "IN"
}
]
}