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

# List promoted purchase ids for an app

Get a list of resource IDs representing promoted purchases for an auto-renewable subscription.

## URL

GET https://api.appstoreconnect.apple.com/v1/apps/{id}/relationships/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

limit: The maximum number of promoted purchase resource identifiers to return.

## Response Codes

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

## See Also

### Endpoints

- [Promote a purchase](appstoreconnectapi/post-v1-promotedpurchases.md)
- [List all promoted purchases for an app](appstoreconnectapi/get-v1-apps-_id_-promotedpurchases.md)
- [Read promoted purchase information](appstoreconnectapi/get-v1-promotedpurchases-_id_.md)
- [Modify a promoted in-app purchase](appstoreconnectapi/patch-v1-promotedpurchases-_id_.md)
- [Modify the order of a promoted purchase for an app](appstoreconnectapi/patch-v1-apps-_id_-relationships-promotedpurchases.md)
- [Remove a promoted purchase](appstoreconnectapi/delete-v1-promotedpurchases-_id_.md)