Единого API на это нет, так как такого понятия как "роль пользователя" в целом то и не существует (формально существуют "ролИ пользователя")
Например, есть пользователь Петр и он находится в Отделе продаж.
Если "Отделу продаж" назначена роль "Менеджер", а Петру - Руководитель, то какую роль имеет Петр? Обе.
Для того чтобы получить обе роли нужно воспользоваться CCrmRole совместно с UserAcceess (чтобы получить все портальные привязки и найти все роли к ним).
Битрикс использует другую концепцию: прав.
Пользователь получает максимально доступные права и на подкорках сам проверяем пользовательские роли.
То есть, вызвав например \CCrmAuthorizationHelper::CheckCreatePermission( \CCrmOwnerType::DealName ) можно получить true или false в зависимости от того может ли пользователь, согласно его ролям создавать сделку.