--- title: Read subscription information framework: appstoreconnectapi role: symbol role_heading: Web Service Endpoint path: appstoreconnectapi/get-v1-subscriptions-_id_ --- # Read subscription information Get information about a specific auto-renewable subscription. ## URL GET https://api.appstoreconnect.apple.com/v1/subscriptions/{id} ## Path Parameters id: ## Query Parameters fields[promotedPurchases]: fields[subscriptionIntroductoryOffers]: fields[subscriptionLocalizations]: fields[subscriptionOfferCodes]: fields[subscriptionPrices]: fields[subscriptions]: include: limit[introductoryOffers]: limit[offerCodes]: limit[prices]: limit[subscriptionLocalizations]: fields[subscriptionPromotionalOffers]: fields[subscriptionAppStoreReviewScreenshots]: limit[promotionalOffers]: fields[subscriptionAvailabilities]: fields[subscriptionGroups]: fields[subscriptionImages]: fields[subscriptionPlanAvailabilities]: fields[winBackOffers]: limit[images]: limit[planAvailabilities]: limit[winBackOffers]: ## Response Codes 200 OK: 400 Bad Request: 401 Unauthorized: 403 Forbidden: 404 Not Found: 429 : ## See Also ### Endpoints - [Create an auto-renewable subscription](appstoreconnectapi/post-v1-subscriptions.md) - [Modify an auto-renewable subscription](appstoreconnectapi/patch-v1-subscriptions-_id_.md) - [Delete a subscription](appstoreconnectapi/delete-v1-subscriptions-_id_.md) - [List all localizations for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-subscriptionlocalizations.md) - [List localization IDs for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-subscriptionlocalizations.md) - [List all introductory offers for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-introductoryoffers.md) - [List all introductory offer resource ids for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-introductoryoffers.md) - [Delete an introductory offer from a subscription](appstoreconnectapi/delete-v1-subscriptions-_id_-relationships-introductoryoffers.md) - [Read promoted purchase information for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-promotedpurchase.md) - [Get the promoted purchase ID for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-promotedpurchase.md) - [List all offer codes for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-offercodes.md) - [List offer code IDs for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-offercodes.md) - [List all promotional offer resource ids for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-promotionaloffers.md) - [List promotional offer IDs for an auto-renewable subscription](appstoreconnectapi/get-v1-subscriptions-_id_-relationships-promotionaloffers.md) - [List all price points for a subscription](appstoreconnectapi/get-v1-subscriptions-_id_-pricepoints.md)