<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/subscription-groups",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Subscription Groups"
}
-->

# Subscription Groups

Create, modify, and delete subscription groups for your app.

## Topics

### Endpoints

[`POST /v1/subscriptionGroups`](/documentation/AppStoreConnectAPI/POST-v1-subscriptionGroups)

Create a subscription group for an app.

[`GET /v1/apps/{id}/subscriptionGroups`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-subscriptionGroups)

Get a list of subscription groups for a specific app.

[`GET /v1/apps/{id}/relationships/subscriptionGroups`](/documentation/AppStoreConnectAPI/GET-v1-apps-_id_-relationships-subscriptionGroups)

[`GET /v1/subscriptionGroups/{id}`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionGroups-_id_)

Get the details of a specific subscription group.

[`PATCH /v1/subscriptionGroups/{id}`](/documentation/AppStoreConnectAPI/PATCH-v1-subscriptionGroups-_id_)

Update the reference name for a specific subscription group.

[`DELETE /v1/subscriptionGroups/{id}`](/documentation/AppStoreConnectAPI/DELETE-v1-subscriptionGroups-_id_)

Delete a specific empty subscription group.

[`GET /v1/subscriptionGroups/{id}/subscriptionGroupLocalizations`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionGroups-_id_-subscriptionGroupLocalizations)

Get a list of all localized metadata for a specific subscription group.

[`GET /v1/subscriptionGroups/{id}/relationships/subscriptionGroupLocalizations`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionGroups-_id_-relationships-subscriptionGroupLocalizations)

[`GET /v1/subscriptionGroups/{id}/subscriptions`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionGroups-_id_-subscriptions)

Get a list of all auto-renewable subscriptions in a subscription group.

[`GET /v1/subscriptionGroups/{id}/relationships/subscriptions`](/documentation/AppStoreConnectAPI/GET-v1-subscriptionGroups-_id_-relationships-subscriptions)

### Objects

[`SubscriptionGroupResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupResponse)

The response body for endpoints that create, read, or modify a single subscription group.

[`SubscriptionGroup`](/documentation/AppStoreConnectAPI/SubscriptionGroup)

A group of related auto-renewable subscriptions that share upgrade, downgrade, and cross-grade eligibility for customers.

[`SubscriptionGroupLocalizationsResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupLocalizationsResponse)

The response body for endpoints that list localizations for a subscription group.

[`SubscriptionGroupLocalization`](/documentation/AppStoreConnectAPI/SubscriptionGroupLocalization)

The localized display name and optional custom app name for a subscription group, shown to customers on the App Store.

[`SubscriptionGroupCreateRequest`](/documentation/AppStoreConnectAPI/SubscriptionGroupCreateRequest)

The request body you use to create a subscription group.

[`SubscriptionGroupUpdateRequest`](/documentation/AppStoreConnectAPI/SubscriptionGroupUpdateRequest)

The request body you use to update a subscription group update request.

[`SubscriptionGroupsResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupsResponse)

The response body for endpoints that list subscription groups for an app.

[`AppSubscriptionGroupsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppSubscriptionGroupsLinkagesResponse)

[`SubscriptionGroupSubscriptionGroupLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupSubscriptionGroupLocalizationsLinkagesResponse)

[`SubscriptionGroupSubscriptionsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupSubscriptionsLinkagesResponse)

A response containing the resource identifiers of subscriptions within a subscription group.

[`SubscriptionGroupSubscriptionGroupLocalizationsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupSubscriptionGroupLocalizationsLinkagesResponse)

[`SubscriptionGroupSubscriptionsLinkagesResponse`](/documentation/AppStoreConnectAPI/SubscriptionGroupSubscriptionsLinkagesResponse)

A response containing the resource identifiers of subscriptions within a subscription group.



---

Copyright &copy; 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)