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}/promotedPurchasesPath Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The opaque resource ID that uniquely identifies the Apps resource. Obtain the app resource ID from the List Apps response. |
Query Parameters
| Name | Type | Description |
|---|---|---|
fields[inAppPurchases] Optional | [string] | |
fields[promotedPurchases] Optional | [string] | |
fields[subscriptions] Optional | [string] | |
include Optional | [string] | The relationship data to include in the response. |
limit Optional | integer | The number of Promoted Purchases resources to return. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | PromotedPurchasesResponse | |
| 400 | Bad Request Content-Type: application/json | ErrorResponse | |
| 401 | Unauthorized Content-Type: application/json | ErrorResponse | |
| 403 | Forbidden Content-Type: application/json | ErrorResponse | |
| 404 | Not Found Content-Type: application/json | ErrorResponse | |
| 429 | Content-Type: application/json | ErrorResponse |