blacklist
Check if a number is in the team blacklist
Checks whether a specific phone number is present in your team's shared blacklist. Returns 200 with the blacklist entry details (including comment) if the number is found, or 404 if it is not blacklisted. Use this for quick lookups before deciding to add or remove a number.
Permission: Numbers Read required.
Monitoring: Required. Team blacklist access is a supervisory feature. Returns 401 Unauthorized if Monitoring is OFF on your API key.
get/blacklists/numbers/{phoneNumber}
Path parameters
phoneNumberinteger required
Example:33612345678
Phone number in E.164 format without the + prefix (e.g., 33612345678).
Response
The number is blacklisted — returns blacklist entry details.
Example response
{
"user_id": 12345,
"team_id": 123456,
"number": 33184800000,
"comment": "Unfriendly",
"direction": "IN"
}