---
title: List the versions of a subscription group
framework: App Store Connect API
role: symbol
role_heading: Web Service Endpoint
platforms: [app store connect api 4.4.1+]
path: appstoreconnectapi/get-v1-subscriptiongroups-_id_-versions
---

# List the versions of a subscription group

List the draft versions of a subscription group.

## URL

GET https://api.appstoreconnect.apple.com/v1/subscriptionGroups/{id}/versions

## Path Parameters

id:

## Query Parameters

filter[state]: fields[subscriptionGroupVersions]: fields[subscriptionGroups]: fields[subscriptionGroupLocalizations]: limit: include: limit[localizations]:

## Response Codes

400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 200 OK: 429 :

## Mentioned in

App Store Connect API 4.4.1 release notes Creating auto-renewable subscription groups Working with subscription group versions

## See Also

### Endpoints

- [Create a subscription group version](appstoreconnectapi/post-v1-subscriptiongroupversions.md)
- [Read subscription group version information](appstoreconnectapi/get-v1-subscriptiongroupversions-_id_.md)
- [List the localizations of a subscription group version](appstoreconnectapi/get-v1-subscriptiongroupversions-_id_-localizations.md)
- [Get the resource IDs of the localizations of a subscription group version](appstoreconnectapi/get-v1-subscriptiongroupversions-_id_-relationships-localizations.md)
- [Get the resource IDs of the versions of a subscription group](appstoreconnectapi/get-v1-subscriptiongroups-_id_-relationships-versions.md)