Link
✎

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

Request
curl --user demo:demo --header "Accept: application/xml" \
  https://go.netlicensing.io/core/v2/rest/utility/licensingModels
Response
<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>

Try it in the API Test Center


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

Request
curl --user demo:demo --header "Accept: application/xml" \
  https://go.netlicensing.io/core/v2/rest/utility/licenseTypes
Response
<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>

Try it in the API Test Center


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

Request
curl --user demo:demo --header "Accept: application/xml" \
  https://go.netlicensing.io/core/v2/rest/utility/countries

Try it in the API Test Center


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

Request
curl --user demo:demo --header "Accept: application/xml" \
  https://go.netlicensing.io/core/v2/rest/utility/currencies

Try it in the API Test Center

Last updated · Edit this page on GitHub