PackageLicense

Represents a license for an installed managed package. This object is available in API version 31.0 and later.

Supported Calls

describeSObjects(), query(), retrieve()

Customer Portal users can't access this object.

Field Name	Details
AllowedLicenses	Type int Properties Filter, Group, Sort Description The number of users allowed to use the package.
ExpirationDate	Type dateTime Properties Filter, Nillable, Sort Description The date and time when the package license expires.
IsAvailableForIntegrations	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Reserved for future use.
NamespacePrefix	Type string Properties Filter, Group, Sort Description The namespace prefix associated with the package.
Status	Type picklist Properties Filter, Group, Restricted picklist, Sort Description The status of the license. Possible values are: Active, Expired, Free, and Trial.
UsedLicenses	Type int Properties Filter, Group, Sort Description The number of users who have a license to the package.

Use this object to determine the number of licenses allowed and in use for a managed package installed in your organization.

The following example demonstrates the use of the API to manage licenses for a package. The example defines an Apex class that does the following.

Retrieves the PackageLicense record for the specified package (identified by its namespace prefix).
Defines a function that returns a list of all users with the specified profile.
Creates a UserPackageLicense record for each user with that profile, which has the effect of assigning a license for the package to all users with that profile.
Returns an error message if the number of users exceeds the number of available licenses.