# Entitlement

## **EARLY RELEASE NOTICE**

This class represents a draft that is designed to inform the OpenActive specification work with implementation feedback. IT IS STILL SUBJECT TO CHANGE, as the [Customer Accounts proposal](https://github.com/openactive/customer-accounts) evolves.

## **Properties**

### **Optional properties**

| Property              | Expected Type                                                                                                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| @type                 | [`Text`](https://schema.org/Text)                                                                                                          | Must always be present and set to `"@type": "Entitlement"`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| entitlementType       | <p><a href="https://developer.openactive.io/data-model/types/concept"><code>Concept</code></a><br>- or -<br><code>@id</code> reference</p> | <p>For the request, this is the value of the @id of the Concept being referenced. For the response, this the full Concept object including the @id and prefLabel.</p><p><br>Example</p><p><code>"entitlementType": {</code><br>  <code>"@type": "Concept",</code><br>  <code>"@id": "<https://data.mcractive.com/openactive/entitlement-list#5e78bcbe-36db-425a-9064-bf96d09cc351>",</code><br>  <code>"prefLabel": "MCRactive Adult Resident",</code><br>  <code>"inScheme": "<https://data.mcractive.com/openactive/entitlement-list>"</code><br><code>}</code></p> |
| evidenceRequestAction | [`Action`](https://developer.openactive.io/data-model/types/action)                                                                        | Any evidence request associated with the entitlement.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| validFrom             | [`Date`](https://schema.org/Date)                                                                                                          | The date the entitlement becomes valid. This must be in the past.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| validUntil            | [`Date`](https://schema.org/Date)                                                                                                          | The date that the entitlement is no longer valid. This must be in the future.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |

Except as otherwise noted, the content of this page is licensed under the [Creative Commons Attribution License (CC-BY V4.0)](https://creativecommons.org/licenses/by/4.0/), and code samples are licensed under the [MIT License](https://opensource.org/licenses/MIT), for anyone to access, use and share; using attribution "[OpenActive](https://www.openactive.io/)".