feat: premium app subscriptions (#833)

Co-authored-by: Vlad Frangu <kingdgrizzle@gmail.com>
Co-authored-by: Jiralite <33201955+Jiralite@users.noreply.github.com>
Co-authored-by: Almeida <almeidx@pm.me>

deno/gateway/v10.ts

@@ -33,6 +33,7 @@ import type {
 	PresenceUpdateStatus,
 	AutoModerationRuleTriggerType,
 	APIAuditLogEntry,
+	APIEntitlement,
 } from '../payloads/v10/mod.ts';
 import type { Nullable } from '../utils/internals.ts';
 
@@ -268,6 +269,9 @@ export enum GatewayDispatchEvents {
 	AutoModerationRuleDelete = 'AUTO_MODERATION_RULE_DELETE',
 	AutoModerationActionExecution = 'AUTO_MODERATION_ACTION_EXECUTION',
 	GuildAuditLogEntryCreate = 'GUILD_AUDIT_LOG_ENTRY_CREATE',
+	EntitlementCreate = 'ENTITLEMENT_CREATE',
+	EntitlementUpdate = 'ENTITLEMENT_UPDATE',
+	EntitlementDelete = 'ENTITLEMENT_DELETE',
 }
 
 export type GatewaySendPayload =
@@ -341,7 +345,8 @@ export type GatewayDispatchPayload =
 	| GatewayVoiceServerUpdateDispatch
 	| GatewayVoiceStateUpdateDispatch
 	| GatewayWebhooksUpdateDispatch
-	| GatewayGuildAuditLogEntryCreateDispatch;
+	| GatewayGuildAuditLogEntryCreateDispatch
+	| GatewayEntitlementModifyDispatch;
 
 // #region Dispatch Payloads
 
@@ -672,6 +677,55 @@ export interface GatewayChannelPinsUpdateDispatchData {
 	last_pin_timestamp?: string | null;
 }
 
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatchData = APIEntitlement;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatch = DataPayload<
+	| GatewayDispatchEvents.EntitlementCreate
+	| GatewayDispatchEvents.EntitlementUpdate
+	| GatewayDispatchEvents.EntitlementDelete,
+	GatewayEntitlementModifyDispatchData
+>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatch = GatewayEntitlementModifyDispatch;
+
 /**
  * https://discord.com/developers/docs/topics/gateway-events#guild-create
  */

deno/gateway/v9.ts

@@ -35,6 +35,7 @@ import type {
 	APIAuditLogEntry,
 } from '../payloads/v9/mod.ts';
 import type { Nullable } from '../utils/internals.ts';
+import type { APIEntitlement } from '../v10.ts';
 
 export * from './common.ts';
 
@@ -267,6 +268,9 @@ export enum GatewayDispatchEvents {
 	AutoModerationRuleDelete = 'AUTO_MODERATION_RULE_DELETE',
 	AutoModerationActionExecution = 'AUTO_MODERATION_ACTION_EXECUTION',
 	GuildAuditLogEntryCreate = 'GUILD_AUDIT_LOG_ENTRY_CREATE',
+	EntitlementCreate = 'ENTITLEMENT_CREATE',
+	EntitlementUpdate = 'ENTITLEMENT_UPDATE',
+	EntitlementDelete = 'ENTITLEMENT_DELETE',
 }
 
 export type GatewaySendPayload =
@@ -340,7 +344,8 @@ export type GatewayDispatchPayload =
 	| GatewayVoiceServerUpdateDispatch
 	| GatewayVoiceStateUpdateDispatch
 	| GatewayWebhooksUpdateDispatch
-	| GatewayGuildAuditLogEntryCreateDispatch;
+	| GatewayGuildAuditLogEntryCreateDispatch
+	| GatewayEntitlementModifyDispatch;
 
 // #region Dispatch Payloads
 
@@ -671,6 +676,55 @@ export interface GatewayChannelPinsUpdateDispatchData {
 	last_pin_timestamp?: string | null;
 }
 
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatchData = APIEntitlement;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatch = DataPayload<
+	| GatewayDispatchEvents.EntitlementCreate
+	| GatewayDispatchEvents.EntitlementUpdate
+	| GatewayDispatchEvents.EntitlementDelete,
+	GatewayEntitlementModifyDispatchData
+>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatch = GatewayEntitlementModifyDispatch;
+
 /**
  * https://discord.com/developers/docs/topics/gateway-events#guild-update
  */

deno/payloads/v10/_interactions/base.ts

@@ -10,6 +10,7 @@ import type {
 	ThreadChannelType,
 } from '../channel.ts';
 import type { APIGuildMember } from '../guild.ts';
+import type { APIEntitlement } from '../monetization.ts';
 import type { APIUser } from '../user.ts';
 import type { InteractionType } from './responses.ts';
 
@@ -130,6 +131,10 @@ export interface APIBaseInteraction<Type extends InteractionType, Data> {
 	 * The guild's preferred locale, if invoked in a guild
 	 */
 	guild_locale?: LocaleString;
+	/**
+	 * For monetized apps, any entitlements for the invoking user, representing access to premium SKUs
+	 */
+	entitlements: APIEntitlement[];
 }
 
 export type APIDMInteractionWrapper<Original extends APIBaseInteraction<InteractionType, unknown>> = Omit<

deno/payloads/v10/_interactions/responses.ts

@@ -24,7 +24,8 @@ export type APIInteractionResponse =
 	| APIInteractionResponseDeferredMessageUpdate
 	| APIInteractionResponseUpdateMessage
 	| APIApplicationCommandAutocompleteResponse
-	| APIModalInteractionResponse;
+	| APIModalInteractionResponse
+	| APIPremiumRequiredInteractionResponse;
 
 export interface APIInteractionResponsePong {
 	type: InteractionResponseType.Pong;
@@ -40,6 +41,10 @@ export interface APIModalInteractionResponse {
 	data: APIModalInteractionResponseCallbackData;
 }
 
+export interface APIPremiumRequiredInteractionResponse {
+	type: InteractionResponseType.PremiumRequired;
+}
+
 export interface APIInteractionResponseChannelMessageWithSource {
 	type: InteractionResponseType.ChannelMessageWithSource;
 	data: APIInteractionResponseCallbackData;
@@ -91,6 +96,10 @@ export enum InteractionResponseType {
 	 * Respond to an interaction with an modal for a user to fill-out
 	 */
 	Modal,
+	/**
+	 * Respond to an interaction with an upgrade button, only available for apps with monetization enabled
+	 */
+	PremiumRequired,
 }
 
 /**

deno/payloads/v10/mod.ts

@@ -18,3 +18,4 @@ export * from './template.ts';
 export * from './user.ts';
 export * from './voice.ts';
 export * from './webhook.ts';
+export * from './monetization.ts';

deno/payloads/v10/monetization.ts

@@ -0,0 +1,115 @@
+import type { Snowflake } from '../../globals.ts';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-structure
+ */
+export interface APIEntitlement {
+	/**
+	 * ID of the entitlement
+	 */
+	id: Snowflake;
+	/**
+	 * ID of the SKU
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the user that is granted access to the entitlement's sku
+	 */
+	user_id?: Snowflake;
+	/**
+	 * ID of the guild that is granted access to the entitlement's sku
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Type of entitlement
+	 */
+	type: EntitlementType;
+	/**
+	 * Whether the entitlement was deleted
+	 */
+	deleted: boolean;
+	/**
+	 * Start date at which the entitlement is valid. Not present when using test entitlements.
+	 */
+	starts_at?: string;
+	/**
+	 * Date at which the entitlement is no longer valid. Not present when using test entitlements.
+	 */
+	ends_at?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-types
+ */
+export enum EntitlementType {
+	/**
+	 * Entitlement was purchased as an app subscription
+	 */
+	ApplicationSubscription = 8,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-structure
+ */
+export interface APISKU {
+	/**
+	 * ID of SKU
+	 */
+	id: Snowflake;
+	/**
+	 * Type of SKU
+	 */
+	type: SKUType;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Customer-facing name of your premium offering
+	 */
+	name: string;
+	/**
+	 * System-generated URL slug based on the SKU's name
+	 */
+	slug: string;
+	/**
+	 * SKU flags combined as a bitfield
+	 *
+	 * See https://en.wikipedia.org/wiki/Bit_field
+	 */
+	flags: SKUFlags;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-flags
+ */
+export enum SKUFlags {
+	/**
+	 * SKU is available for purchase
+	 */
+	Available = 1 << 2,
+	/**
+	 * Recurring SKU that can be purchased by a user and applied to a single server.
+	 * Grants access to every user in that server.
+	 */
+	GuildSubscription = 1 << 7,
+	/**
+	 * Recurring SKU purchased by a user for themselves. Grants access to the purchasing user in every server.
+	 */
+	UserSubscription = 1 << 8,
+}
+
+export enum SKUType {
+	/**
+	 * Represents a recurring subscription
+	 */
+	Subscription = 5,
+	/**
+	 * System-generated group for each Subscription SKU created
+	 */
+	SubscriptionGroup = 6,
+}

deno/payloads/v9/_interactions/base.ts

@@ -10,6 +10,7 @@ import type {
 	ThreadChannelType,
 } from '../channel.ts';
 import type { APIGuildMember } from '../guild.ts';
+import type { APIEntitlement } from '../monetization.ts';
 import type { APIUser } from '../user.ts';
 import type { InteractionType } from './responses.ts';
 
@@ -130,6 +131,10 @@ export interface APIBaseInteraction<Type extends InteractionType, Data> {
 	 * The guild's preferred locale, if invoked in a guild
 	 */
 	guild_locale?: LocaleString;
+	/**
+	 * For monetized apps, any entitlements for the invoking user, representing access to premium SKUs
+	 */
+	entitlements: APIEntitlement[];
 }
 
 export type APIDMInteractionWrapper<Original extends APIBaseInteraction<InteractionType, unknown>> = Omit<

deno/payloads/v9/_interactions/responses.ts

@@ -24,7 +24,8 @@ export type APIInteractionResponse =
 	| APIInteractionResponseDeferredMessageUpdate
 	| APIInteractionResponseUpdateMessage
 	| APIApplicationCommandAutocompleteResponse
-	| APIModalInteractionResponse;
+	| APIModalInteractionResponse
+	| APIPremiumRequiredInteractionResponse;
 
 export interface APIInteractionResponsePong {
 	type: InteractionResponseType.Pong;
@@ -40,6 +41,10 @@ export interface APIModalInteractionResponse {
 	data: APIModalInteractionResponseCallbackData;
 }
 
+export interface APIPremiumRequiredInteractionResponse {
+	type: InteractionResponseType.PremiumRequired;
+}
+
 export interface APIInteractionResponseChannelMessageWithSource {
 	type: InteractionResponseType.ChannelMessageWithSource;
 	data: APIInteractionResponseCallbackData;
@@ -91,6 +96,10 @@ export enum InteractionResponseType {
 	 * Respond to an interaction with an modal for a user to fill-out
 	 */
 	Modal,
+	/**
+	 * Respond to an interaction with an upgrade button, only available for apps with monetization enabled
+	 */
+	PremiumRequired,
 }
 
 /**

deno/payloads/v9/mod.ts

@@ -18,3 +18,4 @@ export * from './template.ts';
 export * from './user.ts';
 export * from './voice.ts';
 export * from './webhook.ts';
+export * from './monetization.ts';

deno/payloads/v9/monetization.ts

@@ -0,0 +1,115 @@
+import type { Snowflake } from '../../globals.ts';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-structure
+ */
+export interface APIEntitlement {
+	/**
+	 * ID of the entitlement
+	 */
+	id: Snowflake;
+	/**
+	 * ID of the SKU
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the user that is granted access to the entitlement's sku
+	 */
+	user_id?: Snowflake;
+	/**
+	 * ID of the guild that is granted access to the entitlement's sku
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Type of entitlement
+	 */
+	type: EntitlementType;
+	/**
+	 * Whether the entitlement was deleted
+	 */
+	deleted: boolean;
+	/**
+	 * Start date at which the entitlement is valid. Not present when using test entitlements.
+	 */
+	starts_at?: string;
+	/**
+	 * Date at which the entitlement is no longer valid. Not present when using test entitlements.
+	 */
+	ends_at?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-types
+ */
+export enum EntitlementType {
+	/**
+	 * Entitlement was purchased as an app subscription
+	 */
+	ApplicationSubscription = 8,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-structure
+ */
+export interface APISKU {
+	/**
+	 * ID of SKU
+	 */
+	id: Snowflake;
+	/**
+	 * Type of SKU
+	 */
+	type: SKUType;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Customer-facing name of your premium offering
+	 */
+	name: string;
+	/**
+	 * System-generated URL slug based on the SKU's name
+	 */
+	slug: string;
+	/**
+	 * SKU flags combined as a bitfield
+	 *
+	 * See https://en.wikipedia.org/wiki/Bit_field
+	 */
+	flags: SKUFlags;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-flags
+ */
+export enum SKUFlags {
+	/**
+	 * SKU is available for purchase
+	 */
+	Available = 1 << 2,
+	/**
+	 * Recurring SKU that can be purchased by a user and applied to a single server.
+	 * Grants access to every user in that server.
+	 */
+	GuildSubscription = 1 << 7,
+	/**
+	 * Recurring SKU purchased by a user for themselves. Grants access to the purchasing user in every server.
+	 */
+	UserSubscription = 1 << 8,
+}
+
+export enum SKUType {
+	/**
+	 * Represents a recurring subscription
+	 */
+	Subscription = 5,
+	/**
+	 * System-generated group for each Subscription SKU created
+	 */
+	SubscriptionGroup = 6,
+}

deno/rest/v10/mod.ts

@@ -18,6 +18,7 @@ export * from './template.ts';
 export * from './user.ts';
 export * from './voice.ts';
 export * from './webhook.ts';
+export * from './monetization.ts';
 
 export const APIVersion = '10';
 
@@ -907,6 +908,28 @@ export const Routes = {
 	currentApplication() {
 		return '/applications/@me' as const;
 	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/entitlements`
+	 * - POST `/applications/{application.id}/entitlements`
+	 */
+	entitlements(applicationId: Snowflake) {
+		return `/applications/${applicationId}/entitlements` as const;
+	},
+	/**
+	 * Route for:
+	 * - DELETE `/applications/{application.id}/entitlements/{entitlement.id}`
+	 */
+	entitlement(applicationId: Snowflake, entitlementId: Snowflake) {
+		return `/applications/${applicationId}/entitlements/${entitlementId}` as const;
+	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/skus`
+	 */
+	skus(applicationId: Snowflake) {
+		return `/applications/${applicationId}/skus` as const;
+	},
 };
 
 export const StickerPackApplicationId = '710982414301790216';

deno/rest/v10/monetization.ts

@@ -0,0 +1,85 @@
+import type { Snowflake } from '../../globals.ts';
+import type { APIEntitlement, APISKU } from '../../v10.ts';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export interface RESTGetAPIEntitlementsQuery {
+	/**
+	 * User ID to look up entitlements for
+	 */
+	user_id?: Snowflake | undefined;
+	/**
+	 * Optional list of SKU IDs to check entitlements for
+	 * Comma-delimited set of snowflakes
+	 */
+	sku_ids?: string | undefined;
+	/**
+	 * Retrieve entitlements before this entitlement ID
+	 */
+	before?: Snowflake | undefined;
+	/**
+	 * Retrieve entitlements after this entitlement ID
+	 */
+	after?: Snowflake | undefined;
+	/**
+	 * Number of entitlements to return (1-100)
+	 *
+	 * @default 100
+	 */
+	limit?: number | undefined;
+	/**
+	 * Guild ID to look up entitlements for
+	 */
+	guild_id?: Snowflake | undefined;
+	/**
+	 * Whether ended entitlements should be omitted
+	 */
+	exclude_ended?: boolean | undefined;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export type RESTGetAPIEntitlementsResult = APIEntitlement[];
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export interface RESTPostAPIEntitlementBody {
+	/**
+	 * ID of the SKU to grant the entitlement to
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the guild or user to grant the entitlement to
+	 */
+	owner_id: Snowflake;
+	/**
+	 * The type of entitlement owner
+	 */
+	owner_type: EntitlementOwnerType;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export type RESTPostAPIEntitlementResult = Partial<Omit<APIEntitlement, 'starts_at' | 'ends_at'>>;
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export enum EntitlementOwnerType {
+	Guild = 1,
+	User,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#delete-test-entitlement
+ */
+export type RESTDeleteAPIEntitlementResult = never;
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#list-skus
+ */
+export type RESTGetAPISKUsResult = APISKU[];

deno/rest/v9/mod.ts

@@ -18,6 +18,7 @@ export * from './template.ts';
 export * from './user.ts';
 export * from './voice.ts';
 export * from './webhook.ts';
+export * from './monetization.ts';
 
 export const APIVersion = '9';
 
@@ -916,6 +917,28 @@ export const Routes = {
 	currentApplication() {
 		return '/applications/@me' as const;
 	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/entitlements`
+	 * - POST `/applications/{application.id}/entitlements`
+	 */
+	entitlements(applicationId: Snowflake) {
+		return `/applications/${applicationId}/entitlements` as const;
+	},
+	/**
+	 * Route for:
+	 * - DELETE `/applications/{application.id}/entitlements/{entitlement.id}`
+	 */
+	entitlement(applicationId: Snowflake, entitlementId: Snowflake) {
+		return `/applications/${applicationId}/entitlements/${entitlementId}` as const;
+	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/skus`
+	 */
+	skus(applicationId: Snowflake) {
+		return `/applications/${applicationId}/skus` as const;
+	},
 };
 
 export const StickerPackApplicationId = '710982414301790216';

deno/rest/v9/monetization.ts

@@ -0,0 +1,85 @@
+import type { Snowflake } from '../../globals.ts';
+import type { APIEntitlement, APISKU } from '../../v10.ts';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export interface RESTGetAPIEntitlementsQuery {
+	/**
+	 * User ID to look up entitlements for
+	 */
+	user_id?: Snowflake | undefined;
+	/**
+	 * Optional list of SKU IDs to check entitlements for
+	 * Comma-delimited set of snowflakes
+	 */
+	sku_ids?: string | undefined;
+	/**
+	 * Retrieve entitlements before this entitlement ID
+	 */
+	before?: Snowflake | undefined;
+	/**
+	 * Retrieve entitlements after this entitlement ID
+	 */
+	after?: Snowflake | undefined;
+	/**
+	 * Number of entitlements to return (1-100)
+	 *
+	 * @default 100
+	 */
+	limit?: number | undefined;
+	/**
+	 * Guild ID to look up entitlements for
+	 */
+	guild_id?: Snowflake | undefined;
+	/**
+	 * Whether ended entitlements should be omitted
+	 */
+	exclude_ended?: boolean | undefined;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export type RESTGetAPIEntitlementsResult = APIEntitlement[];
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export interface RESTPostAPIEntitlementBody {
+	/**
+	 * ID of the SKU to grant the entitlement to
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the guild or user to grant the entitlement to
+	 */
+	owner_id: Snowflake;
+	/**
+	 * The type of entitlement owner
+	 */
+	owner_type: EntitlementOwnerType;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export type RESTPostAPIEntitlementResult = Partial<Omit<APIEntitlement, 'starts_at' | 'ends_at'>>;
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export enum EntitlementOwnerType {
+	Guild = 1,
+	User,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#delete-test-entitlement
+ */
+export type RESTDeleteAPIEntitlementResult = never;
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#list-skus
+ */
+export type RESTGetAPISKUsResult = APISKU[];

gateway/v10.ts

@@ -33,6 +33,7 @@ import type {
 	PresenceUpdateStatus,
 	AutoModerationRuleTriggerType,
 	APIAuditLogEntry,
+	APIEntitlement,
 } from '../payloads/v10/index';
 import type { Nullable } from '../utils/internals';
 
@@ -268,6 +269,9 @@ export enum GatewayDispatchEvents {
 	AutoModerationRuleDelete = 'AUTO_MODERATION_RULE_DELETE',
 	AutoModerationActionExecution = 'AUTO_MODERATION_ACTION_EXECUTION',
 	GuildAuditLogEntryCreate = 'GUILD_AUDIT_LOG_ENTRY_CREATE',
+	EntitlementCreate = 'ENTITLEMENT_CREATE',
+	EntitlementUpdate = 'ENTITLEMENT_UPDATE',
+	EntitlementDelete = 'ENTITLEMENT_DELETE',
 }
 
 export type GatewaySendPayload =
@@ -341,7 +345,8 @@ export type GatewayDispatchPayload =
 	| GatewayVoiceServerUpdateDispatch
 	| GatewayVoiceStateUpdateDispatch
 	| GatewayWebhooksUpdateDispatch
-	| GatewayGuildAuditLogEntryCreateDispatch;
+	| GatewayGuildAuditLogEntryCreateDispatch
+	| GatewayEntitlementModifyDispatch;
 
 // #region Dispatch Payloads
 
@@ -672,6 +677,55 @@ export interface GatewayChannelPinsUpdateDispatchData {
 	last_pin_timestamp?: string | null;
 }
 
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatchData = APIEntitlement;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatch = DataPayload<
+	| GatewayDispatchEvents.EntitlementCreate
+	| GatewayDispatchEvents.EntitlementUpdate
+	| GatewayDispatchEvents.EntitlementDelete,
+	GatewayEntitlementModifyDispatchData
+>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatch = GatewayEntitlementModifyDispatch;
+
 /**
  * https://discord.com/developers/docs/topics/gateway-events#guild-create
  */

gateway/v9.ts

@@ -35,6 +35,7 @@ import type {
 	APIAuditLogEntry,
 } from '../payloads/v9/index';
 import type { Nullable } from '../utils/internals';
+import type { APIEntitlement } from '../v10';
 
 export * from './common';
 
@@ -267,6 +268,9 @@ export enum GatewayDispatchEvents {
 	AutoModerationRuleDelete = 'AUTO_MODERATION_RULE_DELETE',
 	AutoModerationActionExecution = 'AUTO_MODERATION_ACTION_EXECUTION',
 	GuildAuditLogEntryCreate = 'GUILD_AUDIT_LOG_ENTRY_CREATE',
+	EntitlementCreate = 'ENTITLEMENT_CREATE',
+	EntitlementUpdate = 'ENTITLEMENT_UPDATE',
+	EntitlementDelete = 'ENTITLEMENT_DELETE',
 }
 
 export type GatewaySendPayload =
@@ -340,7 +344,8 @@ export type GatewayDispatchPayload =
 	| GatewayVoiceServerUpdateDispatch
 	| GatewayVoiceStateUpdateDispatch
 	| GatewayWebhooksUpdateDispatch
-	| GatewayGuildAuditLogEntryCreateDispatch;
+	| GatewayGuildAuditLogEntryCreateDispatch
+	| GatewayEntitlementModifyDispatch;
 
 // #region Dispatch Payloads
 
@@ -671,6 +676,55 @@ export interface GatewayChannelPinsUpdateDispatchData {
 	last_pin_timestamp?: string | null;
 }
 
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatchData = APIEntitlement;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementModifyDispatch = DataPayload<
+	| GatewayDispatchEvents.EntitlementCreate
+	| GatewayDispatchEvents.EntitlementUpdate
+	| GatewayDispatchEvents.EntitlementDelete,
+	GatewayEntitlementModifyDispatchData
+>;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-create
+ */
+export type GatewayEntitlementCreateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-update
+ */
+export type GatewayEntitlementUpdateDispatch = GatewayEntitlementModifyDispatch;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatchData = GatewayEntitlementModifyDispatchData;
+
+/**
+ * https://discord.com/developers/docs/topics/gateway-events#entitlement-delete
+ */
+export type GatewayEntitlementDeleteDispatch = GatewayEntitlementModifyDispatch;
+
 /**
  * https://discord.com/developers/docs/topics/gateway-events#guild-update
  */

payloads/v10/_interactions/base.ts

@@ -10,6 +10,7 @@ import type {
 	ThreadChannelType,
 } from '../channel';
 import type { APIGuildMember } from '../guild';
+import type { APIEntitlement } from '../monetization';
 import type { APIUser } from '../user';
 import type { InteractionType } from './responses';
 
@@ -130,6 +131,10 @@ export interface APIBaseInteraction<Type extends InteractionType, Data> {
 	 * The guild's preferred locale, if invoked in a guild
 	 */
 	guild_locale?: LocaleString;
+	/**
+	 * For monetized apps, any entitlements for the invoking user, representing access to premium SKUs
+	 */
+	entitlements: APIEntitlement[];
 }
 
 export type APIDMInteractionWrapper<Original extends APIBaseInteraction<InteractionType, unknown>> = Omit<

payloads/v10/_interactions/responses.ts

@@ -24,7 +24,8 @@ export type APIInteractionResponse =
 	| APIInteractionResponseDeferredMessageUpdate
 	| APIInteractionResponseUpdateMessage
 	| APIApplicationCommandAutocompleteResponse
-	| APIModalInteractionResponse;
+	| APIModalInteractionResponse
+	| APIPremiumRequiredInteractionResponse;
 
 export interface APIInteractionResponsePong {
 	type: InteractionResponseType.Pong;
@@ -40,6 +41,10 @@ export interface APIModalInteractionResponse {
 	data: APIModalInteractionResponseCallbackData;
 }
 
+export interface APIPremiumRequiredInteractionResponse {
+	type: InteractionResponseType.PremiumRequired;
+}
+
 export interface APIInteractionResponseChannelMessageWithSource {
 	type: InteractionResponseType.ChannelMessageWithSource;
 	data: APIInteractionResponseCallbackData;
@@ -91,6 +96,10 @@ export enum InteractionResponseType {
 	 * Respond to an interaction with an modal for a user to fill-out
 	 */
 	Modal,
+	/**
+	 * Respond to an interaction with an upgrade button, only available for apps with monetization enabled
+	 */
+	PremiumRequired,
 }
 
 /**

payloads/v10/index.ts

@@ -18,3 +18,4 @@ export * from './template';
 export * from './user';
 export * from './voice';
 export * from './webhook';
+export * from './monetization';

payloads/v10/monetization.ts

@@ -0,0 +1,115 @@
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-structure
+ */
+export interface APIEntitlement {
+	/**
+	 * ID of the entitlement
+	 */
+	id: Snowflake;
+	/**
+	 * ID of the SKU
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the user that is granted access to the entitlement's sku
+	 */
+	user_id?: Snowflake;
+	/**
+	 * ID of the guild that is granted access to the entitlement's sku
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Type of entitlement
+	 */
+	type: EntitlementType;
+	/**
+	 * Whether the entitlement was deleted
+	 */
+	deleted: boolean;
+	/**
+	 * Start date at which the entitlement is valid. Not present when using test entitlements.
+	 */
+	starts_at?: string;
+	/**
+	 * Date at which the entitlement is no longer valid. Not present when using test entitlements.
+	 */
+	ends_at?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-types
+ */
+export enum EntitlementType {
+	/**
+	 * Entitlement was purchased as an app subscription
+	 */
+	ApplicationSubscription = 8,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-structure
+ */
+export interface APISKU {
+	/**
+	 * ID of SKU
+	 */
+	id: Snowflake;
+	/**
+	 * Type of SKU
+	 */
+	type: SKUType;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Customer-facing name of your premium offering
+	 */
+	name: string;
+	/**
+	 * System-generated URL slug based on the SKU's name
+	 */
+	slug: string;
+	/**
+	 * SKU flags combined as a bitfield
+	 *
+	 * See https://en.wikipedia.org/wiki/Bit_field
+	 */
+	flags: SKUFlags;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-flags
+ */
+export enum SKUFlags {
+	/**
+	 * SKU is available for purchase
+	 */
+	Available = 1 << 2,
+	/**
+	 * Recurring SKU that can be purchased by a user and applied to a single server.
+	 * Grants access to every user in that server.
+	 */
+	GuildSubscription = 1 << 7,
+	/**
+	 * Recurring SKU purchased by a user for themselves. Grants access to the purchasing user in every server.
+	 */
+	UserSubscription = 1 << 8,
+}
+
+export enum SKUType {
+	/**
+	 * Represents a recurring subscription
+	 */
+	Subscription = 5,
+	/**
+	 * System-generated group for each Subscription SKU created
+	 */
+	SubscriptionGroup = 6,
+}

payloads/v9/_interactions/base.ts

@@ -10,6 +10,7 @@ import type {
 	ThreadChannelType,
 } from '../channel';
 import type { APIGuildMember } from '../guild';
+import type { APIEntitlement } from '../monetization';
 import type { APIUser } from '../user';
 import type { InteractionType } from './responses';
 
@@ -130,6 +131,10 @@ export interface APIBaseInteraction<Type extends InteractionType, Data> {
 	 * The guild's preferred locale, if invoked in a guild
 	 */
 	guild_locale?: LocaleString;
+	/**
+	 * For monetized apps, any entitlements for the invoking user, representing access to premium SKUs
+	 */
+	entitlements: APIEntitlement[];
 }
 
 export type APIDMInteractionWrapper<Original extends APIBaseInteraction<InteractionType, unknown>> = Omit<

payloads/v9/_interactions/responses.ts

@@ -24,7 +24,8 @@ export type APIInteractionResponse =
 	| APIInteractionResponseDeferredMessageUpdate
 	| APIInteractionResponseUpdateMessage
 	| APIApplicationCommandAutocompleteResponse
-	| APIModalInteractionResponse;
+	| APIModalInteractionResponse
+	| APIPremiumRequiredInteractionResponse;
 
 export interface APIInteractionResponsePong {
 	type: InteractionResponseType.Pong;
@@ -40,6 +41,10 @@ export interface APIModalInteractionResponse {
 	data: APIModalInteractionResponseCallbackData;
 }
 
+export interface APIPremiumRequiredInteractionResponse {
+	type: InteractionResponseType.PremiumRequired;
+}
+
 export interface APIInteractionResponseChannelMessageWithSource {
 	type: InteractionResponseType.ChannelMessageWithSource;
 	data: APIInteractionResponseCallbackData;
@@ -91,6 +96,10 @@ export enum InteractionResponseType {
 	 * Respond to an interaction with an modal for a user to fill-out
 	 */
 	Modal,
+	/**
+	 * Respond to an interaction with an upgrade button, only available for apps with monetization enabled
+	 */
+	PremiumRequired,
 }
 
 /**

payloads/v9/index.ts

@@ -18,3 +18,4 @@ export * from './template';
 export * from './user';
 export * from './voice';
 export * from './webhook';
+export * from './monetization';

payloads/v9/monetization.ts

@@ -0,0 +1,115 @@
+import type { Snowflake } from '../../globals';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-structure
+ */
+export interface APIEntitlement {
+	/**
+	 * ID of the entitlement
+	 */
+	id: Snowflake;
+	/**
+	 * ID of the SKU
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the user that is granted access to the entitlement's sku
+	 */
+	user_id?: Snowflake;
+	/**
+	 * ID of the guild that is granted access to the entitlement's sku
+	 */
+	guild_id?: Snowflake;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Type of entitlement
+	 */
+	type: EntitlementType;
+	/**
+	 * Whether the entitlement was deleted
+	 */
+	deleted: boolean;
+	/**
+	 * Start date at which the entitlement is valid. Not present when using test entitlements.
+	 */
+	starts_at?: string;
+	/**
+	 * Date at which the entitlement is no longer valid. Not present when using test entitlements.
+	 */
+	ends_at?: string;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#entitlement-object-entitlement-types
+ */
+export enum EntitlementType {
+	/**
+	 * Entitlement was purchased as an app subscription
+	 */
+	ApplicationSubscription = 8,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-structure
+ */
+export interface APISKU {
+	/**
+	 * ID of SKU
+	 */
+	id: Snowflake;
+	/**
+	 * Type of SKU
+	 */
+	type: SKUType;
+	/**
+	 * ID of the parent application
+	 */
+	application_id: Snowflake;
+	/**
+	 * Customer-facing name of your premium offering
+	 */
+	name: string;
+	/**
+	 * System-generated URL slug based on the SKU's name
+	 */
+	slug: string;
+	/**
+	 * SKU flags combined as a bitfield
+	 *
+	 * See https://en.wikipedia.org/wiki/Bit_field
+	 */
+	flags: SKUFlags;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#sku-object-sku-flags
+ */
+export enum SKUFlags {
+	/**
+	 * SKU is available for purchase
+	 */
+	Available = 1 << 2,
+	/**
+	 * Recurring SKU that can be purchased by a user and applied to a single server.
+	 * Grants access to every user in that server.
+	 */
+	GuildSubscription = 1 << 7,
+	/**
+	 * Recurring SKU purchased by a user for themselves. Grants access to the purchasing user in every server.
+	 */
+	UserSubscription = 1 << 8,
+}
+
+export enum SKUType {
+	/**
+	 * Represents a recurring subscription
+	 */
+	Subscription = 5,
+	/**
+	 * System-generated group for each Subscription SKU created
+	 */
+	SubscriptionGroup = 6,
+}

rest/v10/index.ts

@@ -18,6 +18,7 @@ export * from './template';
 export * from './user';
 export * from './voice';
 export * from './webhook';
+export * from './monetization';
 
 export const APIVersion = '10';
 
@@ -907,6 +908,28 @@ export const Routes = {
 	currentApplication() {
 		return '/applications/@me' as const;
 	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/entitlements`
+	 * - POST `/applications/{application.id}/entitlements`
+	 */
+	entitlements(applicationId: Snowflake) {
+		return `/applications/${applicationId}/entitlements` as const;
+	},
+	/**
+	 * Route for:
+	 * - DELETE `/applications/{application.id}/entitlements/{entitlement.id}`
+	 */
+	entitlement(applicationId: Snowflake, entitlementId: Snowflake) {
+		return `/applications/${applicationId}/entitlements/${entitlementId}` as const;
+	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/skus`
+	 */
+	skus(applicationId: Snowflake) {
+		return `/applications/${applicationId}/skus` as const;
+	},
 };
 
 export const StickerPackApplicationId = '710982414301790216';

rest/v10/monetization.ts

@@ -0,0 +1,85 @@
+import type { Snowflake } from '../../globals';
+import type { APIEntitlement, APISKU } from '../../v10';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export interface RESTGetAPIEntitlementsQuery {
+	/**
+	 * User ID to look up entitlements for
+	 */
+	user_id?: Snowflake | undefined;
+	/**
+	 * Optional list of SKU IDs to check entitlements for
+	 * Comma-delimited set of snowflakes
+	 */
+	sku_ids?: string | undefined;
+	/**
+	 * Retrieve entitlements before this entitlement ID
+	 */
+	before?: Snowflake | undefined;
+	/**
+	 * Retrieve entitlements after this entitlement ID
+	 */
+	after?: Snowflake | undefined;
+	/**
+	 * Number of entitlements to return (1-100)
+	 *
+	 * @default 100
+	 */
+	limit?: number | undefined;
+	/**
+	 * Guild ID to look up entitlements for
+	 */
+	guild_id?: Snowflake | undefined;
+	/**
+	 * Whether ended entitlements should be omitted
+	 */
+	exclude_ended?: boolean | undefined;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export type RESTGetAPIEntitlementsResult = APIEntitlement[];
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export interface RESTPostAPIEntitlementBody {
+	/**
+	 * ID of the SKU to grant the entitlement to
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the guild or user to grant the entitlement to
+	 */
+	owner_id: Snowflake;
+	/**
+	 * The type of entitlement owner
+	 */
+	owner_type: EntitlementOwnerType;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export type RESTPostAPIEntitlementResult = Partial<Omit<APIEntitlement, 'starts_at' | 'ends_at'>>;
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export enum EntitlementOwnerType {
+	Guild = 1,
+	User,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#delete-test-entitlement
+ */
+export type RESTDeleteAPIEntitlementResult = never;
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#list-skus
+ */
+export type RESTGetAPISKUsResult = APISKU[];

rest/v9/index.ts

@@ -18,6 +18,7 @@ export * from './template';
 export * from './user';
 export * from './voice';
 export * from './webhook';
+export * from './monetization';
 
 export const APIVersion = '9';
 
@@ -916,6 +917,28 @@ export const Routes = {
 	currentApplication() {
 		return '/applications/@me' as const;
 	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/entitlements`
+	 * - POST `/applications/{application.id}/entitlements`
+	 */
+	entitlements(applicationId: Snowflake) {
+		return `/applications/${applicationId}/entitlements` as const;
+	},
+	/**
+	 * Route for:
+	 * - DELETE `/applications/{application.id}/entitlements/{entitlement.id}`
+	 */
+	entitlement(applicationId: Snowflake, entitlementId: Snowflake) {
+		return `/applications/${applicationId}/entitlements/${entitlementId}` as const;
+	},
+	/**
+	 * Route for:
+	 * - GET `/applications/{application.id}/skus`
+	 */
+	skus(applicationId: Snowflake) {
+		return `/applications/${applicationId}/skus` as const;
+	},
 };
 
 export const StickerPackApplicationId = '710982414301790216';

rest/v9/monetization.ts

@@ -0,0 +1,85 @@
+import type { Snowflake } from '../../globals';
+import type { APIEntitlement, APISKU } from '../../v10';
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export interface RESTGetAPIEntitlementsQuery {
+	/**
+	 * User ID to look up entitlements for
+	 */
+	user_id?: Snowflake | undefined;
+	/**
+	 * Optional list of SKU IDs to check entitlements for
+	 * Comma-delimited set of snowflakes
+	 */
+	sku_ids?: string | undefined;
+	/**
+	 * Retrieve entitlements before this entitlement ID
+	 */
+	before?: Snowflake | undefined;
+	/**
+	 * Retrieve entitlements after this entitlement ID
+	 */
+	after?: Snowflake | undefined;
+	/**
+	 * Number of entitlements to return (1-100)
+	 *
+	 * @default 100
+	 */
+	limit?: number | undefined;
+	/**
+	 * Guild ID to look up entitlements for
+	 */
+	guild_id?: Snowflake | undefined;
+	/**
+	 * Whether ended entitlements should be omitted
+	 */
+	exclude_ended?: boolean | undefined;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#list-entitlements
+ */
+export type RESTGetAPIEntitlementsResult = APIEntitlement[];
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export interface RESTPostAPIEntitlementBody {
+	/**
+	 * ID of the SKU to grant the entitlement to
+	 */
+	sku_id: Snowflake;
+	/**
+	 * ID of the guild or user to grant the entitlement to
+	 */
+	owner_id: Snowflake;
+	/**
+	 * The type of entitlement owner
+	 */
+	owner_type: EntitlementOwnerType;
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export type RESTPostAPIEntitlementResult = Partial<Omit<APIEntitlement, 'starts_at' | 'ends_at'>>;
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#create-test-entitlement
+ */
+export enum EntitlementOwnerType {
+	Guild = 1,
+	User,
+}
+
+/**
+ * https://discord.com/developers/docs/monetization/entitlements#delete-test-entitlement
+ */
+export type RESTDeleteAPIEntitlementResult = never;
+
+/**
+ * https://discord.com/developers/docs/monetization/skus#list-skus
+ */
+export type RESTGetAPISKUsResult = APISKU[];