--- schema_version: "1" id: a5758c4f2b589f461ff902ebb8b9d624fff554cf818c3b294ceaa23548dd77f3 title: Entitlement collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_entitlement.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_entitlement.htm source_site: developer.salesforce.com content_type: documentation content_hash: 0a2a90743869d3929a030b71f75b5eff177b468fdf0e23c2b980e15dd32de892 description: Represents the customer support an account or contact is eligible to receive. This object is available in API version 18.0 and later. Entitlements may be based on an asset, product, or service contract. --- # Entitlement Represents the customer support an account or contact is eligible to receive. This object is available in API version 18.0 and later. Entitlements may be based on an asset, product, or service contract. ## Supported Calls create(), delete(), describeLayout(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field | Details | | --- | --- | | AccountId | Type reference Properties Create, Filter, Group, Sort Description ID of the Account associated with the entitlement. | | AssetId | Type reference Properties Filter, Group, Nillable, Sort Description Required. ID of the Asset associated with the entitlement. | | AssetWarrantyID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The identifier of the asset warranty record. Must be a valid asset warranty ID. AssetWarranty is available only with Field Service. | | BusinessHoursId | Type reference Properties Filter, Group, Nillable, Sort Description Required. ID of the BusinessHours associated with the entitlement. | | CasesPerEntitlement | Type int Properties Filter, Group, Nillable, Sort Description The total number of cases the entitlement supports. This field is only available if IsPerIncident is true. | | ContractLineItemId | Type reference Properties Filter, Group, Nillable, Sort Description ID of the ContractLineItem associated with the entitlement. | | EndDate | Type date Properties Create, Filter, Nillable, Update Description The last day the entitlement is in effect. | | IsPerIncident | Type boolean Properties Defaulted on create, Filter, Update Description Indicates whether the entitlement is limited to supporting a specific number of cases (true) or not (false). | | LastReferencedDate | Type date Properties Filter, Nillable, Sort, Update Description The timestamp when the current user last accessed this record, a record related to this record, or a list view. | | LastViewedDate | Type date Properties Filter, Nillable, Sort, Update Description The timestamp when the current user last viewed this record or list view. If this value is null, the user might have only accessed this record or list view (LastReferencedDate) but not viewed it. | | LocationID | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the Location associated with the entitlement. | | Name | Type string Properties Create, Filter, Update Description Required. Name of the entitlement. | | SvcApptBookingWindowsId | Type reference Properties Create, Filter, Group, Sort, Nillable, Update Description The operating hours that the entitlement’s work orders should respect. The label in the user interface is Operating Hours. Available only if Field Service is enabled. | | RemainingCases | Type int Properties Create, Filter, Nillable, Update Description The number of cases the entitlement can support. This field decreases in value by one each time a case is created with the entitlement. This field is only available if IsPerIncident is selected. | | RemainingWorkOrders | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The number of agreed work orders remaining to be created. | | ServiceContractId | Type reference Properties Create, Filter, Nillable, Update Description Required. ID of the ServiceContract associated with the entitlement. | | SlaProcessId | Type reference Properties Create, Filter, Nillable, Update Description ID of the SlaProcess associated with the entitlement. This field is available in version 19.0 and later. | | StartDate | Type date Properties Create, Filter, Nillable, Update Description The first date the entitlement is in effect. | | Status | Type picklist Properties Filter, Nillable Description Status of the entitlement, such as Expired. | | SvcApptBookingWindows | Type reference Properties Create, Filter, Group, Sort, Nillable, Update Description The operating hours of the entitlement. This field is visible only if Field Service is enabled. | | Type | Type picklist Properties Create, Defaulted on create, Filter, Nillable, Update Description The type of entitlement, such as Web or phone support. | | | | | WorkOrdersPerEntitlement | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description Total number of work orders available for this entitlement. | ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [EntitlementChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 44.0) Change events are available for the object. [EntitlementFeed](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") (API version 23.0) Feed tracking is available for the object. [EntitlementHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. #### See Also - [EntitlementContact](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_entitlementcontact.htm "Represents a Contact eligible to receive customer support via an Entitlement. This object is available in API version 18.0 and later.") - [SlaProcess](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_slaprocess.htm "Represents an entitlement process associated with an Entitlement. This object is available in API version 19.0 and later.")