Contents

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

NameTypeDescription
id Requiredstring

An opaque resource ID that uniquely identifies the resource. Obtain the app resource ID from the List apps response.

Query Parameters

NameTypeDescription
limit Optionalinteger

The maximum number of promoted purchase resource identifiers to return.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
AppPromotedPurchasesLinkagesResponse

400Bad Request
Content-Type: application/json
ErrorResponse

401Unauthorized
Content-Type: application/json
ErrorResponse

403Forbidden
Content-Type: application/json
ErrorResponse

404Not Found
Content-Type: application/json
ErrorResponse

429
Content-Type: application/json
ErrorResponse

See Also

Endpoints