Document new entitlement endpoint behavior (discord#7279)

* Document new entitlement endpoint behavior

* Clarify defaults

Author: appellation

docs/resources/Entitlement.md

@@ -64,15 +64,16 @@ Returns all entitlements for a given app, active and expired.
 
 ###### Query String Params
 
-| param          | type                                             | description                                          |
-|----------------|--------------------------------------------------|------------------------------------------------------|
-| user_id?       | snowflake                                        | User ID to look up entitlements for                  |
-| sku_ids?       | comma-delimited set of snowflakes                | Optional list of SKU IDs to check entitlements for   |
-| before?        | snowflake                                        | Retrieve entitlements before this entitlement ID     |
-| after?         | snowflake                                        | Retrieve entitlements after this entitlement ID      |
-| limit?         | integer                                          | Number of entitlements to return, 1-100, default 100 |
-| guild_id?      | snowflake                                        | Guild ID to look up entitlements for                 |
-| exclude_ended? | [boolean](#DOCS_REFERENCE/boolean-query-strings) | Whether or not ended entitlements should be omitted  |
+| param            | type                                             | description                                                                                                                |
+|------------------|--------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|
+| user_id?         | snowflake                                        | User ID to look up entitlements for                                                                                        |
+| sku_ids?         | comma-delimited set of snowflakes                | Optional list of SKU IDs to check entitlements for                                                                         |
+| before?          | snowflake                                        | Retrieve entitlements before this entitlement ID                                                                           |
+| after?           | snowflake                                        | Retrieve entitlements after this entitlement ID                                                                            |
+| limit?           | integer                                          | Number of entitlements to return, 1-100, default 100                                                                       |
+| guild_id?        | snowflake                                        | Guild ID to look up entitlements for                                                                                       |
+| exclude_ended?   | [boolean](#DOCS_REFERENCE/boolean-query-strings) | Whether or not ended entitlements should be omitted. Defaults to false, ended entitlements are included by default.        |
+| exclude_deleted? | [boolean](#DOCS_REFERENCE/boolean-query-strings) | Whether or not deleted entitlements should be omitted. Defaults to true, deleted entitlements are not included by default. |
 
 ```json
 [
@@ -94,6 +95,28 @@ Returns all entitlements for a given app, active and expired.
 ]
 ```
 
+## Get Entitlement % GET /applications/{application.id#DOS_RESOURCES_APPLICATION/application-object}/entitlements/{entitlement.id#DOCS_RESOURCES_ENTITLEMENT/entitlement-object}
+
+Returns an entitlement.
+
+```json
+{
+  "id": "1019653849998299136",
+  "sku_id": "1019475255913222144",
+  "application_id": "1019370614521200640",
+  "user_id": "771129655544643584",
+  "promotion_id": null,
+  "type": 8,
+  "deleted": false,
+  "gift_code_flags": 0,
+  "consumed": false,
+  "starts_at": "2022-09-14T17:00:18.704163+00:00",
+  "ends_at": "2022-10-14T17:00:18.704163+00:00",
+  "guild_id": "1015034326372454400",
+  "subscription_id": "1019653835926409216"
+}
+```
+
 ## Consume an Entitlement % POST /applications/{application.id#DOCS_RESOURCES_APPLICATION/application-object}/entitlements/{entitlement.id#DOCS_RESOURCES_ENTITLEMENT/entitlement-object}/consume
 
 For One-Time Purchase consumable SKUs, marks a given entitlement for the user as consumed. The entitlement will have `consumed: true` when using [List Entitlements](#DOCS_RESOURCES_ENTITLEMENT/list-entitlements).
@@ -128,4 +151,4 @@ After creating a test entitlement, you'll need to reload your Discord client. Af
 
 Deletes a currently-active test entitlement. Discord will act as though that user or guild _no longer has_ entitlement to your premium offering.
 
-Returns `204 No Content` on success.
+Returns `204 No Content` on success.