Web Service Endpoint

Get a User's Storefront

Fetch a user’s storefront.

URL

GET https://api.music.apple.com/v1/me/storefront

Query Parameters

l
string

The localization to use, specified by a language tag. Any supported language tag may be used here. If none is specified, en-US is used.

Response Codes

OK

The request was successful.

Discussion

This endpoint requires a music user token. See Getting Keys and Creating Tokens.

If successful, the HTTP status code is 200 (OK) and the data array in the ResponseRoot object contains a single Storefront object. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array. See Handle a Response.

Example

https://api.music.apple.com/v1/me/storefront
{ "data": [ { "attributes": { "defaultLanguageTag": "en-US", "name": "United States", "supportedLanguageTags": [ "en-US", "es-MX" ] }, "href": "/v1/storefronts/us", "id": "us", "type": "storefronts" } ]}

See Also

Storefronts

Get a Storefront

Fetch a single storefront by using its identifier.

Get Multiple Storefronts

Fetch one or more storefronts by using their identifiers.

Get All Storefronts

Fetch all the storefronts in alphabetical order.