Get Entitlement Details (XML) by entId

Returns a list of line items, with Products, Features, and License Model, for the provided entId. Eid and createdBy are automatically included in the response body.

Method Type URI
GET v90/ws/entitlement/{entId}.ws

URI Parameters

Parameter Description Type
entId

The unique identifier for the Entitlement in the database.

NOTE   This is different from the Entitlement ID string. Examples:

>entId: 10 (integer)

>Entitlement ID (or EID): gd5f6vfg-y57f-he55-3r5d7w9g7tx3 (string)

Integer (>0)

Sample Request

Not applicable.

Sample Response

Success

HTTP Status Code: 200

NOTE   If your entitlement contains memory segments with blank spaces in addition to the content, then the XML returned by the Get Entitlement web service will replace the blank spaces with all zeros. To re-use this XML, replace the content (including the zeros) with its hexadecimal equivalent so that memory data is correctly updated in Sentinel LDK-EMS and can be referred to in both the web service and GUI without any issues.

Response Body:

    <entitlement>
     <eid>eee560bf-d46f-4659-ab3a-f0bec8a9969a</eid>
     <createdBy>admin</createdBy>
     <startDate>2016-10-17</startDate>.
     <startDate>2016-10-17</startDate>.
     <endDate>2500-12-31</endDate>
     <createDate>2016-10-17</createDate>
     <commitDate>2016-10-17</commitDate>
     <enabled>true</enabled>
     <entState>COMPLETED</entState>
     <isTest>false</isTest>
     <customerId>1</customerId>
     <customerEmail>manishgarg@gmail.com</customerEmail>
     <policy>
      <registrationRequired>NOT_REQUIRED</registrationRequired>
    </policy>
    <refId1>
    </refId1>
    <refId2>
    </refId2>
    <description>
    </description>
    <entitlementItem>
     <startDate>2016-10-17</startDate>
     <endDate>2500-12-31</endDate>
     <numProductKeys>1</numProductKeys>
     <numActivationPerProductKey>1</numActivationPerProductKey>
     <priority>D</priority>
     <vendorId>1</vendorId>
     <enforcementId>2</enforcementId>
     <identityCount>-1</identityCount>
     <lineItemType>Product_Key</lineItemType>
     <deploymentType>Cloud</deploymentType>
     <itemProduct>
      <productId>1</productId>
      <product>
       <productName>CP1</productName>
       <baseProductId>0</baseProductId>
       <productIdentifier>2</productIdentifier>
       <lifeCycleStage>COMMIT</lifeCycleStage>
       <enforcementProductType>BASE</enforcementProductType>
       <enforcementProtectionType>HL_or_SL_AdminMode_or_SL_UserMode</enforcementProtectionType>
       <rehost>LEAVE_AS_IS</rehost>
       <productDescription>
       </productDescription>
       <refId1>
       </refId1>
       <refId2>
       </refId2>
       <enabled>true</enabled>
       <deployed>true</deployed>
       <productFeatureRef>
        <featureId>1</featureId>
        <actionName>NONE</actionName>
        <productFeatureLicenseModel>
         <actionName>NONE</actionName>
         <licenseModel>
	      <licenseModelId>8</licenseModelId>
	      <licenseModelName>Postpaid</licenseModelName>
          <licenseType>0</licenseType>
	      <lmAttribute>
	       <attribute>
		    <attributeId>31</attributeId>
		    <attributeName>DEPLOYMENT_TYPE</attributeName>
		    <attributeType>7</attributeType>
		    <attributeValueChoice>		     
		     <valueOption>On-Premise</valueOption>
		    </attributeValueChoice>
		    <attributeDefaultValue>
		    </attributeDefaultValue>
		    <displayOrder>4</displayOrder>
		    <attributeLevel>1</attributeLevel>
		    <associatedLockCriteria>
		    </associatedLockCriteria>
		    <associatedLockCriteriaValue>
		    </associatedLockCriteriaValue>
		    <endUserPermission>0</endUserPermission>
		    <parameterGroupName>Deployment Attibute</parameterGroupName>
		    <parameterSubGroupName>Deployment Attibute</parameterSubGroupName>
		    <isvPermission>WRITE</isvPermission>
		    <nullable>false</nullable>
		    <saotAllowed>true</saotAllowed>
	       </attribute>
	       <attributeValue>03</attributeValue>
	       <saot>false</saot>
	       <actionName>NONE</actionName>
          </lmAttribute>
	      <lmAttribute>
	       <attribute>
		    <attributeId>32</attributeId>
		    <attributeName>KEEP_ALIVE_TIME</attributeName>
		    <attributeType>3</attributeType>
		    <attributeDefaultValue>
		    </attributeDefaultValue>
		    <displayOrder>5</displayOrder>
		    <attributeLevel>1</attributeLevel>
		    <associatedLockCriteria>
		    </associatedLockCriteria>
		    <associatedLockCriteriaValue>
		    </associatedLockCriteriaValue>
		    <endUserPermission>0</endUserPermission>
		    <parameterGroupName>Deployment Attibute</parameterGroupName>
		    <parameterSubGroupName>Deployment Attibute</parameterSubGroupName>
		    <isvPermission>WRITE</isvPermission>
		    <nullable>false</nullable>
		    <saotAllowed>true</saotAllowed>
	      </attribute>
	      <attributeValue>30</attributeValue>
	      <saot>false</saot>
	      <actionName>NONE</actionName>
	     </lmAttribute>
	     <lmAttribute>
	       <attribute>
		    <attributeId>22</attributeId>
		    <attributeName>USAGE_TYPE</attributeName>
		    <attributeType>7</attributeType>
		    <attributeValueChoice>
		    <valueOption>Count Based</valueOption>
		    <valueOption>Time Based</valueOption>
		    </attributeValueChoice>
		    <attributeDefaultValue>
		    </attributeDefaultValue>
		    <displayOrder>4</displayOrder>
		    <attributeLevel>1</attributeLevel>
		    <associatedLockCriteria>
		    </associatedLockCriteria>
		    <associatedLockCriteriaValue>
		    </associatedLockCriteriaValue>
		    <endUserPermission>0</endUserPermission>
		    <parameterGroupName>Usage Type</parameterGroupName>
		    <parameterSubGroupName>Usage Type</parameterSubGroupName>
		    <isvPermission>WRITE</isvPermission>
		    <nullable>false</nullable>
		    <saotAllowed>true</saotAllowed>
	    </attribute>
	    <attributeValue>2</attributeValue>
	    <saot>true</saot>
	    <actionName>NONE</actionName>
     </lmAttribute>
     <lmAttribute>
        <attribute>
	     <attributeId>25</attributeId>
	     <attributeName>LICENSE_TYPE</attributeName>
	     <attributeType>1</attributeType>
	     <attributeDefaultValue>
	     </attributeDefaultValue>
	     <displayOrder>1</displayOrder>
	     <attributeLevel>1</attributeLevel>
	     <associatedLockCriteria>
	     </associatedLockCriteria>
	     <associatedLockCriteriaValue>
	     </associatedLockCriteriaValue>
	     <endUserPermission>0</endUserPermission>
	     <parameterGroupName>UserID</parameterGroupName>
	     <parameterSubGroupName>UserID</parameterSubGroupName>
	     <isvPermission>WRITE</isvPermission>
	     <nullable>false</nullable>
	     <saotAllowed>true</saotAllowed>
      </attribute>
      <attributeValue>2</attributeValue>
      <saot>false</saot>
      <actionName>NONE</actionName>
    </lmAttribute>
    <lmAttribute>
      <attribute>
	    <attributeId>21</attributeId>
	    <attributeName>END_DATE</attributeName>
	    <attributeType>2</attributeType>
	    <attributeDefaultValue>
	    </attributeDefaultValue>
	    <displayOrder>2</displayOrder>
	    <attributeLevel>1</attributeLevel>
	    <associatedLockCriteria>
	    </associatedLockCriteria>
	    <associatedLockCriteriaValue>
	    </associatedLockCriteriaValue>
	    <endUserPermission>0</endUserPermission>
	    <parameterGroupName>Time</parameterGroupName>
	    <parameterSubGroupName>License Validity</parameterSubGroupName>
	    <isvPermission>WRITE</isvPermission>
	    <nullable>false</nullable>
	    <saotAllowed>true</saotAllowed>
       </attribute>
       <attributeValue>2500-12-31 00:00</attributeValue>
       <saot>true</saot>
       <actionName>NONE</actionName>
    </lmAttribute>
    <lmAttribute>
    <attribute>
    	<attributeId>20</attributeId>
    	<attributeName>START_DATE</attributeName>
    	<attributeType>2</attributeType>
    	<attributeDefaultValue>
    	</attributeDefaultValue>
    	<displayOrder>1</displayOrder>
    	<attributeLevel>1</attributeLevel>
    	<associatedLockCriteria>
    	</associatedLockCriteria>
    	<associatedLockCriteriaValue>
    	</associatedLockCriteriaValue>
	    <endUserPermission>0</endUserPermission>
	    <parameterGroupName>Time</parameterGroupName>
	    <parameterSubGroupName>License Validity</parameterSubGroupName>
	    <isvPermission>WRITE</isvPermission>
	    <nullable>false</nullable>
	    <saotAllowed>true</saotAllowed>
      </attribute>
      <attributeValue>2016-10-03 00:00</attributeValue>
      <saot>true</saot>
      <actionName>NONE</actionName>
    </lmAttribute>
    <lmAttribute>
       <attribute>
	    <attributeId>33</attributeId>
	    <attributeName>REFRESH_PERIOD</attributeName>
	    <attributeType>3</attributeType>
	    <attributeDefaultValue>
	    </attributeDefaultValue>
	    <displayOrder>5</displayOrder>
	    <attributeLevel>1</attributeLevel>
	    <associatedLockCriteria>
	    </associatedLockCriteria>
	    <associatedLockCriteriaValue>
	    </associatedLockCriteriaValue>
	    <endUserPermission>0</endUserPermission>
	    <parameterGroupName>Deployment Attibute</parameterGroupName>
	    <parameterSubGroupName>Deployment Attibute</parameterSubGroupName>
	    <isvPermission>WRITE</isvPermission>
	    <nullable>false</nullable>
	    <saotAllowed>true</saotAllowed>
     </attribute>
     <attributeValue>80</attributeValue>
     <saot>false</saot>
     <actionName>NONE</actionName>
    </lmAttribute>
    <lmAttribute>
      <attribute>
	    <attributeId>30</attributeId>
	    <attributeName>DISCONNECTED_TIME</attributeName>
	    <attributeType>3</attributeType>
	    <attributeDefaultValue>
	    </attributeDefaultValue>
	    <displayOrder>3</displayOrder>
	    <attributeLevel>1</attributeLevel>
	    <associatedLockCriteria>
	    </associatedLockCriteria>
	    <associatedLockCriteriaValue>
	    </associatedLockCriteriaValue>
	    <endUserPermission>0</endUserPermission>
	    <parameterGroupName>Deployment Attibute</parameterGroupName>
	    <parameterSubGroupName>Deployment Attibute</parameterSubGroupName>
	    <isvPermission>WRITE</isvPermission>
	    <nullable>false</nullable>
	    <saotAllowed>true</saotAllowed>
      </attribute>
      <attributeValue>1</attributeValue>
      <saot>false</saot>
      <actionName>NONE</actionName>
    </lmAttribute>
    <lmAttribute>
      <attribute>
	    <attributeId>34</attributeId>
	    <attributeName>VENDOR_ATTRIBUTE</attributeName>
	    <attributeType>1</attributeType>
	    <attributeDefaultValue>
	    </attributeDefaultValue>
	    <displayOrder>5</displayOrder>
	    <attributeLevel>1</attributeLevel>
	    <associatedLockCriteria>
	    </associatedLockCriteria>
	    <associatedLockCriteriaValue>
	    </associatedLockCriteriaValue>
	    <endUserPermission>0</endUserPermission>
	    <parameterGroupName>Vendor Attribute</parameterGroupName>
	    <parameterSubGroupName>Vendor Attribute</parameterSubGroupName>
	    <isvPermission>WRITE</isvPermission>
	    <nullable>false</nullable>
	    <saotAllowed>true</saotAllowed>
       </attribute>
       <attributeValue>
       </attributeValue>
       <saot>true</saot>
       <actionName>NONE</actionName>
      </lmAttribute>
     </licenseModel>
    </productFeatureLicenseModel>
    <lmStatus>DEFINED</lmStatus>
    <excludable>true</excludable>
    <featureName>F1</featureName>
    <featureIdentifier>1</featureIdentifier>
    <featureDescription>
    </featureDescription>
   </productFeatureRef>
  </product>
  <productStatus>ENABLE</productStatus>
 </itemProduct>
 <productKeyId>a7c4d8e7-6387-4fd2-8544-6517abe40bc4</productKeyId>
 <pcId>3f7d30bb-3080-41ad-a857-97bc9eefebf6</pcId>
</entitlementItem>
</entitlement>

Count_Criteria

>0 - Station

>1 - Login

>2 - Process

Counting_Type

>1 - Per login

>2 - Per Identity

>3 - Per Identity per station

Failure

HTTP Status Code: 404

Response Body: Entitlement does not exist. Try again with a correct entId.