Contents

Get Metadata for Your Authenticated Purchases

Fetch metadata for your authenticated purchases by using their identifiers with a specified resource type.

URL

GET https://api.ent.apple.com/v1/catalog/{storefront}/stoken-authenticated-purchases

Path Parameters

NameTypeDescription
storefront Requiredstring

An iTunes Store territory that you specify with an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefrontobjects.

Query Parameters

NameTypeDescription
extend Optional[string]

A list of attribute extensions to apply to resources in the response. These attributes are usually more expensive, so only extend them if absolutely necessary.

Classifier (optional): A resource type to apply the parameter to, apps, books, or in-apps.

ids Required[string]

The unique identifiers for the purchases.

Classifier (required): The resource type of the purchase, apps, books, or in-apps.

include Optional[string]

A list of relationship names to include for resources in the response.

Classifier (optional): A resource type to apply the parameter to.

l Optionalstring

The localization to use, which you specify with a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object that storefront specifies. Otherwise, the default is defaultLanguageTag in Storefront.

relate Optional[string]

A list of relationship names to relate for resources in the response.

Classifier (optional): A resource type to apply the parameter to.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
ResourceCollectionResponse

The request was successful.

401Unauthorized
Content-Type: application/json
UnauthorizedResponse

A response indicating an incorrect Authorization header.

500Internal Server Error
Content-Type: application/json
ErrorsResponse

A response indicating an error occurred on the server.

Discussion

Example Request and Response

Topics

Responses

See Also

Retrieving app and book metadata