# Subscription plan availability Create and manage subscription plan availability for auto-renewable subscriptions. ## Discussion The `subscriptionPlanAvailabilities` resource lets you control which subscription plan type — monthly or up-front — is available for a subscription in specific territories. There are two possible values for the subscription plan type: `MONTHLY` and `UPFRONT`. To learn more, see [`SubscriptionPlanType`](/documentation/AppStoreConnectAPI/SubscriptionPlanType) and [Set availability for an auto-renewable subscription](https://developer.apple.com/help/app-store-connect/manage-subscriptions/set-availability-for-an-auto-renewable-subscription). Use it to: - Create a plan availability configuration for a subscription. - Read or modify the available territories for a plan availability. - Update available territories for a subscription plan availability. ## Topics ### Creating and modifying plan availability [`Create a subscription plan availability`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionPlanAvailabilities) Create the plan availability configuration for an auto-renewable subscription. [`Read subscription plan availability information`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionPlanAvailabilities-_id_) Get information about a specific subscription plan availability. [`Modify a subscription plan availability`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionPlanAvailabilities-_id_) Update the plan availability configuration for a specific subscription. ### Managing available territories [`List available territories for a subscription plan availability`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionPlanAvailabilities-_id_-availableTerritories) List all territories where a specific subscription plan is available. [`List available territory IDs for a subscription plan availability`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionPlanAvailabilities-_id_-relationships-availableTerritories) Get a list of available territory resource IDs for a specific subscription plan availability. [`Replace the available territories for a subscription plan availability`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionPlanAvailabilities-_id_-relationships-availableTerritories) Replace the list of available territories for a specific subscription plan availability. ### Reading plan availability from a subscription [`List plan availabilities for a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-planAvailabilities) List all plan availabilities for a specific auto-renewable subscription. [`List plan availability IDs for a subscription`](/documentation/AppStoreConnectAPI/GET-v1-subscriptions-_id_-relationships-planAvailabilities) Get a list of plan availability resource IDs for a specific auto-renewable subscription. ### Objects and types [`object SubscriptionPlanAvailability`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailability) A configuration object for a subscription’s plan availability, specifying the plan type, the territories in which it is available, and whether it’s automatically available in new territories. [`object SubscriptionPlanAvailabilityCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilityCreateRequest) The request body you use to create a subscription plan availability. [`object SubscriptionPlanAvailabilityUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilityUpdateRequest) The request body you use to modify a subscription plan availability. [`object SubscriptionPlanAvailabilityResponse`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilityResponse) The response body for endpoints that create or read a single subscription plan availability. [`object SubscriptionPlanAvailabilitiesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilitiesResponse) The response body for endpoints that list subscription plan availabilities. [`object SubscriptionPlanAvailabilitiesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilitiesLinkagesResponse) A response containing the resource identifiers of subscription plan availabilities. [`object SubscriptionPlanAvailabilityAvailableTerritoriesLinkagesRequest`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilityAvailableTerritoriesLinkagesRequest) A request body you use to replace the available territories for a subscription plan availability. [`object SubscriptionPlanAvailabilityAvailableTerritoriesLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionPlanAvailabilityAvailableTerritoriesLinkagesResponse) A response containing the resource identifiers of available territories for a subscription plan availability. [`string SubscriptionPlanType`](/documentation/AppStoreConnectAPI/SubscriptionPlanType) A string that indicates the billing plan type for an auto-renewable subscription. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)