---
title: List all promoted purchases for an app
framework: appstoreconnectapi
role: symbol
role_heading: Web Service Endpoint
path: appstoreconnectapi/get-v1-apps-_id_-promotedpurchases
---

# List all promoted purchases for an app

Get a list of promoted in-app purchases, including promoted auto-renewable subscriptions, for an app.

## URL

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

## 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[inAppPurchases]: Additional fields to include for each in-app purchase resource returned by the response. fields[promotedPurchases]: Additional fields to include for each promoted purchase resource returned by the response. fields[subscriptions]: Additional fields to include for each subscription resource returned by the response. include: The relationship data to include in the response. limit: The maximum number of promoted purchase resources to return.

## Response Codes

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

## Mentioned in

Managing auto-renewable subscriptions Managing in-app purchases

## Discussion

Discussion Example Request and Response

## See Also

### Getting in-app purchase information

- [Read in-app purchase information](appstoreconnectapi/get-v1-inapppurchases-_id_.md)
- [List all in-app purchases for an app v1](appstoreconnectapi/get-v1-apps-_id_-inapppurchases.md)