Retrieving Entitlements

Entitlements APIs for retrieving user entitlements information


The user's current entitlement status can be retrieved by calling the getEntitlementsConsumption method. This retrieves information about the user's current level of entitlement as well as information about any entitlements consumed.

do {
  let entitlements = try await entitlementsClient.getEntitlementsConsumption()
  // Handle entitlements
catch (let error) {
  // Handle error

The getEntitlementsConsumption method returns an EntitlementsConsumption object that specifies both the user's entitlements and any consumption of those entitlements.

Entitlements may be consumed by the user themselves or may be consumed by sub-resources of the user.

For example the sudoplatform.sudo.max entitlement controls the maximum number of Sudo Profiles a user may have at any one time. This entitlement is consumed at the user level. Conversely the sudoplatform.virtual-cards.virtual-cardMaxPerSudo specifies how many Sudo Virtual Cards may be active for any single Sudo Profile. Each Sudo Profile's consumption of this entitlement is listed separately in the EntitlementsConsumption object. Consumers are identified by an id (in the case of a Sudo Profile this is the Sudo Profile's ID) and the issuer of the ID (sudoplatform.sudoservice for Sudo Profile IDs).


The getEntitlementsConsumption API will throw errors in the the following circumstances:





User was not signed in when getEntitlements was invoked.

Ensure user is signed in prior to invoking getEntitlements


The user's token does not contain a claim that can be mapped to an entitlements set, or the user has not been pre-configured with initial entitlements.

Ensure your identity provider has been set up to include an expected claim when federating sign-on or pre-configure the user with entitlements.


The user has not called redeemEntitlements yet and so their identity is not bound to any entitlements

Ensure redeemEntitlements has been called prior to attempting to retrieve entitlements consumption information


A transient error occurred in the service while retrieving entitlements.

Retry the request. If the problem persists, ask us for help

Last updated