> For the complete documentation index, see [llms.txt](https://docs.sudoplatform.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sudoplatform.com/guides/telephony/telephony-entitlements.md).

# Telephony Entitlements

The Sudo Platform entitlements system is used to control consumption of Sudo Platform resources and the Telephony service integrates with this system.

Access to the Telephony service is controlled at the user level and users are either entitled to use the capability or they are not.

{% hint style="info" %}
Read more about the Sudo Platform entitlements system and how to integrate with it in the [Entitlements](https://docs.sudoplatform.com/guides/entitlements) section of the Sudo Platform documentation.
{% endhint %}

The following table describes the entitlements used to control access to the Telephony service:

| Entitlement                                    | Description                                                                           |
| ---------------------------------------------- | ------------------------------------------------------------------------------------- |
| `sudoplatform.telephony.serviceUserEntitled`   | Whether or not user is entitled to use the Sudo Platform Privacy Interaction service. |
| `sudoplatform.telephony.phoneNumberMaxPerUser` | Maximum number of phone numbers that a user can provision.                            |
| `sudoplatform.telephony.phoneNumberMaxPerSudo` | Maximum number of phone numbers that a user can provision for each Sudo.              |

### Retrieving Entitlements Information

To determine whether a user is entitled or whether they have consumed that entitlement, call the `getEntitlementsConsumption` API in the Entitlements SDK. This will return an `EntitlementsConsumption` object that specifies both the user's entitlements level across all entitled Sudo Platform services and how much of each entitlement has been consumed.

{% hint style="info" %}
Read more about the `getEntitlementsConsumptionAPI` available in the Entitlements SDK user API [here](https://docs.sudoplatform.com/guides/entitlements/end-user-api/retrieving-entitlements#getentitlementsconsumption).
{% endhint %}
