Get a Storefront
Fetch a single storefront by using its identifier.
URL
GET https://api.music.apple.com/v1/storefronts/{id}Path Parameters
| Name | Type | Description |
|---|---|---|
id Required | string | The identifier (an ISO 3166 alpha-2 country code) for the storefront you want to fetch. |
Query Parameters
| Name | Type | Description |
|---|---|---|
l Optional | string | The localization to use, specified by a language tag. The possible values are in the |
include Optional | [string] | Additional relationships to include in the fetch. |
extend Optional | [string] | A list of attribute extensions to apply to resources in the response. |
Response Codes
| Status | Reason | Type | Description |
|---|---|---|---|
| 200 | OK Content-Type: application/json | StorefrontsResponse | The request was successful. |
| 401 | Unauthorized Content-Type: application/json | UnauthorizedResponse | A response indicating an incorrect |
| 500 | Internal Server Error Content-Type: application/json | ErrorsResponse | A response indicating an error occurred on the server. |
Discussion
If successful, the HTTP status code is 200 (OK) and the data array contains a single Storefronts object. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array.