Utility Services
Reference data such as licensing models, license types, countries and currencies.
Authentication, formats, error codes, paging and role levels are the same for all endpoints and described on the Conventions page. Paths are relative to https://go.netlicensing.io/core/v2/rest. Every call can be tried in the API Test Center.
| Endpoint | Purpose | Role |
|---|---|---|
GET /utility/licensingModels | List licensing models | Analytics+ |
GET /utility/licenseTypes | List license types | Analytics+ |
GET /utility/countries | List countries | Analytics+ |
GET /utility/currencies | List currencies | Analytics+ |
A role followed by “+” means that role and every higher one, see Roles.
Licensing Models list
GET /utility/licensingModels
Required role: Analytics+
Return a list of all licensing models supported by the service.
One LicensingModelProperties item (property name) per registered model.
Parameters: none.
Example
curl --user demo:demo --header "Accept: application/xml" \
https://go.netlicensing.io/core/v2/rest/utility/licensingModels
<netlicensing xmlns="http://netlicensing.labs64.com/schema/context">
<items>
<item type="LicensingModelProperties">
<property name="name">TimeLimitedEvaluation</property>
</item>
<item type="LicensingModelProperties">
<property name="name">FeatureWithTimeVolume</property>
</item>
</items>
</netlicensing>
License Types list
GET /utility/licenseTypes
Required role: Analytics+
Return a list of all license types supported by the service.
One LicenseType item (property name) per value of LicenseType.
Parameters: none.
Example
curl --user demo:demo --header "Accept: application/xml" \
https://go.netlicensing.io/core/v2/rest/utility/licenseTypes
<netlicensing xmlns="http://netlicensing.labs64.com/schema/context">
<items>
<item type="LicenseType">
<property name="name">FEATURE</property>
</item>
<item type="LicenseType">
<property name="name">TIMEVOLUME</property>
</item>
</items>
</netlicensing>
Countries list
GET /utility/countries
Required role: Analytics+
Return a list of all countries.
Country items with properties code, name, vatPercent, isEu.
Parameters: none.
Example
curl --user demo:demo --header "Accept: application/xml" \
https://go.netlicensing.io/core/v2/rest/utility/countries
Currencies list
GET /utility/currencies
Required role: Analytics+
Return a list of all currencies.
Currency items (property name), one for each currency except NONE.
Parameters: none.
Example
curl --user demo:demo --header "Accept: application/xml" \
https://go.netlicensing.io/core/v2/rest/utility/currencies