---
title: Promoted Purchases
framework: appstoreconnectapi
role: collectionGroup
role_heading: API Collection
path: appstoreconnectapi/promoted-purchases
---

# Promoted Purchases

Manage the in-app purchase or auto-renewable subscription that’s promoted on an app listing in the App Store.

## Topics

### Endpoints

- [Promote a purchase](appstoreconnectapi/post-v1-promotedpurchases.md)
- [List all promoted purchases for an app](appstoreconnectapi/get-v1-apps-_id_-promotedpurchases.md)
- [List promoted purchase ids for an app](appstoreconnectapi/get-v1-apps-_id_-relationships-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)

### Objects

- [PromotedPurchaseResponse](appstoreconnectapi/promotedpurchaseresponse.md)
- [PromotedPurchasesResponse](appstoreconnectapi/promotedpurchasesresponse.md)
- [PromotedPurchaseCreateRequest](appstoreconnectapi/promotedpurchasecreaterequest.md)
- [PromotedPurchaseUpdateRequest](appstoreconnectapi/promotedpurchaseupdaterequest.md)
- [AppPromotedPurchasesLinkagesRequest](appstoreconnectapi/apppromotedpurchaseslinkagesrequest.md)
- [AppPromotedPurchasesLinkagesResponse](appstoreconnectapi/apppromotedpurchaseslinkagesresponse.md)

## See Also

### Managing Promoted Purchases

- [Promoted Purchase Images](appstoreconnectapi/promoted-purchase-images.md)