---
title: List all subscription groups for an app
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-apps-_id_-subscriptiongroups
---

# List all subscription groups for an app

Get a list of subscription groups for a specific app.

## URL

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

## Path Parameters

id: An opaque resource ID that uniquely identifies the resource. Obtain the app resource ID from the List apps response.

## Query Parameters

fields[subscriptionGroupLocalizations]: Additional fields to include for each subscription group localization resource returned by the response. fields[subscriptionGroups]: Additional fields to include for each subscription group resource returned by the response. fields[subscriptions]: Additional fields to include for each subscription resource returned by the response. filter[referenceName]: Filter the returned subscription groups by reference name. filter[subscriptions.state]: Filter the returned subscription groups by subscriptions state. include: The relationship data to include in the response. limit: The maximum number of subscription group resources to return. limit[subscriptionGroupLocalizations]: The maximum number of related subscription group localizations resources to return. limit[subscriptions]: The maximum number of related subscriptions resources to return. sort: Attributes by which to sort.

## Response Codes

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

## See Also

### Getting subscription group and subscription grace period information

- [Read the billing grace period value for an app](appstoreconnectapi/get-v1-apps-_id_-subscriptiongraceperiod.md)
- [Get the subscription grace period ID for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-subscriptiongraceperiod.md)
- [List subscription group IDs for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-subscriptiongroups.md)