         (service/trap #(games/get-games (->params-map sort-order sort-dir limit offset))))
 
   (GET* "/games/:game-id" [game-id]
-        :path-params [game-id :- Long]
-       (service/trap #(game/get-game game-id)))
+        :summary     "Get a single game."
+        :path-params [game-id :- Long]
+        (service/trap #(game/get-game game-id)))
 
   (GET* "/games/:game-id/songs" [game-id]
-        :path-params [game-id :- Long]
-       (service/trap #(game/get-game-songs game-id)))
+        :summary     "Get songs for a single game."
+        :path-params [game-id :- Long]
+        (service/trap #(game/get-game-songs game-id)))
 
   (GET* "/games/:game-id/albums" [game-id]
-        :path-params [game-id :- Long]
-       (service/trap #(game/get-game-albums game-id)))
+        :summary     "Get albums for a single game."
+        :path-params [game-id :- Long]
+        (service/trap #(game/get-game-albums game-id)))
 
   (GET* "/games/:game-id/remixes" [game-id]
-        :path-params [game-id :- Long]
-       (service/trap #(game/get-game-remixes game-id)))
+        :summary     "Get remixes for a single game."
+        :path-params [game-id :- Long]
+        (service/trap #(game/get-game-remixes game-id)))
 
   (GET* "/albums" []
+        :summary      "List all albums."
         :query-params [{sort-order :- String "release_date"}
                        {sort-dir :- String "DESC"}
                        {limit :- Long 50}

        (service/trap #(albums/get-albums (->params-map sort-order sort-dir limit offset))))

  (GET* "/albums/:album-id" [album-id]
        :path-params [album-id :- Long]
       (service/trap #(album/get-album album-id)))

  (GET* "/albums/:album-id/composers" [album-id]
        :path-params [album-id :- Long]
       (service/trap #(album/get-album-composers album-id)))

  (GET* "/albums/:album-id/remixes" [album-id]
        :path-params [album-id :- Long]
       (service/trap #(album/get-album-remixes album-id)))

  (GET* "/artists" []
        :query-params [{sort-order :- String "name"}
                       {sort-dir :- String "ASC"}
                       {limit :- Long 50}


(defroutes* api-routes
  (GET* "/remixes" []
        :summary      "List all remixes."
        :query-params [{sort-order :- String "id"}
                       {sort-dir :- String "DESC"}
                       {limit :- Long 50}
