---
title: Get a Catalog Genre
framework: Apple Music API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple music 1.0+]
path: applemusicapi/get-a-genre
---

# Get a Catalog Genre

Fetch a genre by using its identifier.

## URL

GET https://api.music.apple.com/v1/catalog/{storefront}/genres/{id}

## Path Parameters

id: The unique identifier for the genre. storefront: An iTunes Store territory, specified by an ISO 3166 alpha-2 country code. The possible values are the id attributes of Storefront objects.

## Query Parameters

l: The localization to use, specified by a language tag. The possible values are in the supportedLanguageTags array belonging to the Storefront object specified by storefront. Otherwise, the default is defaultLanguageTag in Storefront. include: Additional relationships to include in the fetch. extend: A list of attribute extensions to apply to resources in the response.

## Response Codes

200 OK: The request was successful. 401 Unauthorized: A response indicating an incorrect Authorization header. 500 Internal Server Error: A response indicating an error occurred on the server.

## Discussion

Discussion If successful, the HTTP status code is 200 (OK) and the data array contains a single Genre object. If unsuccessful, the HTTP status code indicates the error and the details are in the errors array. For more information, see Handling Requests and Responses. Example

## See Also

### Related Documentation

- [Genres](applemusicapi/genres.md)
- [GenresResponse](applemusicapi/genresresponse.md)

### Requesting Catalog Genres

- [Get Multiple Catalog Genres](applemusicapi/get-multiple-genres.md)
- [Get Catalog Top Charts Genres](applemusicapi/get-all-genres.md)