GET ​/api​/v3​/genres

Returns a list of the known genres and genre groups.

Request

Example Request

{
}

Example Parameters

Response

Example Response

{
  "genre_groups": [
    {
      "name": "Rock",
      "subtitle": "Indie, Pop, Alternative",
      "position": 1,
      "genres": [
        "Rock"
      ],
      "excluded_genres": [
        "Metal"
      ],
      "photos": {
        "fullscreen": "https://deliradio.s3.amazonaws.com/assets/genre_group/fullscreen_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg",
        "fullscreen_retina": "https://deliradio.s3.amazonaws.com/assets/genre_group/fullscreen_retina_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg",
        "preview": "https://deliradio.s3.amazonaws.com/assets/genre_group/preview_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg",
        "preview_retina": "https://deliradio.s3.amazonaws.com/assets/genre_group/preview_retina_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg",
        "small_wide": "https://deliradio.s3.amazonaws.com/assets/genre_group/small_wide_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg",
        "small_wide_retina": "https://deliradio.s3.amazonaws.com/assets/genre_group/small_wide_retina_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg"
      }
    }
  ],
  "genres": [
    "Rock"
  ]
}

Response Parameters

  • genre_groups: A list of the genre groups

    • Required: no
    • Type: array
    • Items

      • Required: no
      • name: The name of the genre group.
        • Required: no
        • Type: string
        • Example: Rock
      • subtitle: A secondary description of the genre group.
        • Required: no
        • Type: string
        • Example: Indie, Pop, Alternative
      • position: The position this genre group should be displayed in a UI
        • Required: no
        • Type: number
        • Example: 1
      • genres: The actual list of genre's this group contains.

        • Required: no
        • Type: array
        • Example: [ "Rock", "Indie", "Blues" ]
        • Items

          • Required: no
          • Type: string
          • Example: Rock
      • excluded_genres: The list of genres specifically excluded from this genre group.

        • Required: no
        • Type: array
        • Example: [ "Metal", "Punk" ]
        • Items

          • Required: no
          • Type: string
          • Example: Metal
      • photos: A list of default photos for genre group.

        • Required: yes
        • fullscreen: A fullscreen artist photo
          • Required: no
          • Type:
            • null
            • string
          • Format: uri
          • Example: https://deliradio.s3.amazonaws.com/assets/genregroup/fullscreenc31b785e-31e1-4fac-9d55-1b4d138f2982.jpg
        • fullscreen_retina: A fullscreen retina artist photo
          • Required: no
          • Type:
            • null
            • string
          • Format: uri
          • Example: https://deliradio.s3.amazonaws.com/assets/genregroup/fullscreenretina_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg
        • preview: A preview artist photo
          • Required: no
          • Type:
            • null
            • string
          • Format: uri
          • Example: https://deliradio.s3.amazonaws.com/assets/genregroup/previewc31b785e-31e1-4fac-9d55-1b4d138f2982.jpg
        • preview_retina: A retina preview artist photo
          • Required: no
          • Type:
            • null
            • string
          • Format: uri
          • Example: https://deliradio.s3.amazonaws.com/assets/genregroup/previewretina_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg
        • small_wide: A small sized artist photo
          • Required: no
          • Type:
            • null
            • string
          • Format: uri
          • Example: https://deliradio.s3.amazonaws.com/assets/genregroup/smallwide_c31b785e-31e1-4fac-9d55-1b4d138f2982.jpg
        • smallwideretina: A retina small sized artist photo
          • Required: no
          • Type:
            • null
            • string
          • Format: uri
          • Example: https://deliradio.s3.amazonaws.com/assets/genregroup/smallwideretinac31b785e-31e1-4fac-9d55-1b4d138f2982.jpg
  • genres: The list of known genres.

    • Required: no
    • Type: array
    • Example: [ "Rock", "Pop", "Jazz", "Indie" ]
    • Items ???
      • Required: yes
      • Type: string
      • Example: Rock

Response Codes

Successful Response Codes

  • 200:

Failure Response Codes