# Get playlist **GET /data/playlists/{instance_id}** Retrieve a playlist by its ID and return it as a JSON object. Supports including relations. Requires project access. Vendor access is blocked. ## Servers - http://api.example.com: http://api.example.com () ## Authentication methods - Jwt authorization ## Parameters ### Path parameters - **instance_id** (string(uuid)) ### Query parameters - **relations** (boolean) Whether to include relations ## Responses ### 200 Playlist retrieved successfully #### Body: application/json (object) - **id** (string(uuid)) - **name** (string) - **project_id** (string(uuid)) - **episode_id** (string(uuid)) - **task_type_id** (string(uuid)) - **shots** (array[object]) - **created_at** (string(date-time)) - **updated_at** (string(date-time)) ### 400 Invalid ID format or query error [Powered by Bump.sh](https://bump.sh)