List all licenses

Returns a list of licenses. The licenses are returned sorted by creation date in ascending order.

GET/v3/licenses
JWT
license:read

Parameters

NameTypeInDescription
pageintegerqueryThe page number.
limitintegerqueryThe number of records per page. Must be a number between 1 and 100.
sortstringqueryThe sort string to sort the returned records e.g. "-createdAt"
userIdstringqueryUnique identifier for the user. A user is associated with a license directly, via a user group, or through the additionalUserIds property.
organizationIdobjectqueryUnique identifier for the organization.
activation.lastSyncedAtobjectqueryThe last synced at date of the activation linked to the license.
activation.countryCodeobjectqueryThe country code of the activation linked to the license.
productIdobjectqueryUnique identifier for the product.
productVersionIdobjectqueryUnique identifier for the product version.
resellerIdobjectqueryUnique identifier for the reseller.
user.emailobjectqueryEmail address of the user.
user.companyobjectqueryCompany of the user.
organization.nameobjectqueryOrganization associated with the license.
allowVmActivationbooleanqueryWhether activation is allowed inside a virtual machine.
userLockedbooleanqueryWhether activation is locked to the machine user.
expiringSoonbooleanqueryWhether license is about to expire based on the value of expiringSoonEventOffset.
maintenanceExpiringSoonbooleanqueryWhether license maintenance is about to expire based on the value of expiringSoonEventOffset.
expirationStrategystringqueryExpiration strategy of the license.
subscriptionStartTriggerobjectquerySubscription start trigger for the license.
tagsobjectqueryTags associated with the license.
maintenanceExpiresAtobjectqueryMaintenance expiration date of the license.
activatedAtobjectqueryThe date when the license was first activated.
lastUsedAtobjectqueryThe date when the license was last used at (activated or synced).
keyobjectqueryThe key associated with the license.
revokedbooleanqueryWhether a license is revoked.
suspendedbooleanqueryWhether a license is suspended.
typeobjectqueryType of the license.
validityobjectqueryThe duration after which the license will expire.
subscriptionIntervalobjectquerySubscription interval for the license.
allowedActivationsobjectqueryAllowed number of activations for the license.
allowedDeactivationsobjectqueryAllowed number of deactivations for the license.
totalActivationsobjectqueryTotal number of activations for the license.
totalDeactivationsobjectqueryTotal number of deactivations for the license.
notesobjectqueryThe license notes.
metadata.keyobjectqueryMetadata key associated with the license.
metadata.valueobjectqueryMetadata value associated with the license.
expiresAtobjectqueryLicenses expiring at.
expiredbooleanqueryWhether license is expired.
perpetualbooleanqueryWhether license is perpetual.
entitlementSetIdobjectqueryID of the linked entitlement set.
searchstringquerySearch string.
idobjectqueryID of the resource.
createdAtobjectqueryDate of creation
updatedAtobjectqueryDate of last update

Responses

200 OK
[
  {
    "id": "string",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "key": "string",
    "revoked": true,
    "suspended": true,
    "perpetual": true,
    "totalActivations": 0,
    "totalDeactivations": 0,
    "validity": 0,
    "expirationStrategy": "immediate",
    "subscriptionInterval": "string",
    "subscriptionStartTrigger": "creation",
    "fingerprintMatchingStrategy": "fuzzy",
    "allowedActivations": 0,
    "allowedDeactivations": 0,
    "type": "node-locked",
    "allowedFloatingClients": 0,
    "serverSyncGracePeriod": 0,
    "serverSyncInterval": 0,
    "allowedClockOffset": 0,
    "cryptoBindingEnabled": true,
    "disableClockValidation": true,
    "expiringSoonEventOffset": 0,
    "leaseDuration": 0,
    "leasingStrategy": "per-machine",
    "effectiveDate": "2019-08-24T14:15:22Z",
    "expiresAt": "2019-08-24T14:15:22Z",
    "activatedAt": "2019-08-24T14:15:22Z",
    "lastUsedAt": "2019-08-24T14:15:22Z",
    "allowVmActivation": true,
    "allowContainerActivation": true,
    "allowClientLeaseDuration": true,
    "userLocked": true,
    "requireAuthentication": true,
    "disableGeoLocation": true,
    "notes": "string",
    "productId": "string",
    "entitlementSetId": "string",
    "productVersionId": "string",
    "maintenancePolicyId": "string",
    "maintenanceExpiresAt": "2019-08-24T14:15:22Z",
    "currentReleaseVersion": "string",
    "maxAllowedReleaseVersion": "string",
    "organizationId": "string",
    "organization": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "email": "string",
      "description": "string",
      "allowedUsers": 0,
      "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "city": "string",
        "state": "string",
        "country": "string",
        "postalCode": "string"
      },
      "resellerId": "string",
      "reseller": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "allowedOrganizations": 0
      }
    },
    "userId": "string",
    "user": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "firstName": "string",
      "lastName": "string",
      "email": "string",
      "role": "string",
      "twoFactorEnabled": true,
      "googleSsoEnabled": true,
      "lastLoginAt": "2019-08-24T14:15:22Z",
      "company": "string",
      "allowCustomerPortalAccess": true,
      "roles": [
        "string"
      ],
      "lastSeenAt": "2019-08-24T14:15:22Z",
      "organizationId": "string",
      "organization": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "address": {
          "addressLine1": "string",
          "addressLine2": "string",
          "city": "string",
          "state": "string",
          "country": "string",
          "postalCode": "string"
        },
        "resellerId": "string",
        "reseller": {
          "id": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "name": "string",
          "email": "string",
          "description": "string",
          "allowedUsers": 0,
          "allowedOrganizations": 0
        }
      },
      "resellerId": "string",
      "reseller": {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "email": "string",
        "description": "string",
        "allowedUsers": 0,
        "allowedOrganizations": 0
      },
      "metadata": [
        {
          "id": "string",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "key": "string",
          "value": "string",
          "viewPermissions": [
            "activation"
          ],
          "visible": true
        }
      ],
      "tags": [
        "string"
      ],
      "emailPreference": {
        "metrics": true
      }
    },
    "resellerId": "string",
    "reseller": {
      "id": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "name": "string",
      "email": "string",
      "description": "string",
      "allowedUsers": 0,
      "allowedOrganizations": 0
    },
    "additionalUserIds": [
      "string"
    ],
    "allowedIpRange": "string",
    "allowedIpRanges": [
      "string"
    ],
    "allowedIpAddresses": [
      "string"
    ],
    "disallowedIpAddresses": [
      "string"
    ],
    "allowedCountries": [
      "string"
    ],
    "disallowedCountries": [
      "string"
    ],
    "metadata": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "key": "string",
        "value": "string",
        "viewPermissions": [
          "activation"
        ],
        "visible": true
      }
    ],
    "meterAttributes": [
      {
        "id": "string",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "name": "string",
        "allowedUses": 0,
        "totalUses": 0,
        "grossUses": 0,
        "floating": true,
        "viewPermissions": [
          "activation"
        ],
        "visible": true
      }
    ],
    "tags": [
      "string"
    ]
  }
]