Web Service Endpoint

Get a Storefront

Fetch a single storefront by using its identifier.

URL

GET https://api.music.apple.com/v1/storefronts/{id}

Path Parameters

id
string
(Required)

The identifier (an ISO 3166 alpha-2 country code) for the storefront you want to fetch.

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

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/storefronts/jp
{ "data": [ { "attributes": { "defaultLanguageTag": "ja", "name": "Japan", "supportedLanguageTags": [ "ja", "en-US" ] }, "href": "/v1/storefronts/jp", "id": "jp", "type": "storefronts" } ]}

See Also

Requesting a Catalog Storefront

Get a User's Storefront

Fetch a user’s storefront.

Get Multiple Storefronts

Fetch one or more storefronts by using their identifiers.

Get All Storefronts

Fetch all the storefronts in alphabetical order.