---
title: "List mixtapes."
method: GET
path: "/2/vod/channels/{channel}/mixtapes"
tags: ["V3 > Mixtape"]
---

# List mixtapes.

`GET /2/vod/channels/{channel}/mixtapes`

Retrieves a paginated list of mixtapes associated with the provided channel.

## Path parameters

- `channel` string, required

## Query parameters

- `color` string — Mixtape color
- `criteria` string, nullable — a string free of XSS payloads
- `description` string, nullable — a string free of XSS payloads
- `mixtapes` string, nullable — A list of items, (either comma separated or as an array) (no duplicates) with the following rules: <note><bold>1</bold>: Identifier of an existing Mixtape</note>
- `name` string — a string free of XSS payloads
- `order` object[] — Specify the order for the desired queried Media
  - `direction` '"asc"' | '"desc"', nullable
  - `key` 'collected_at' | 'created_at' | 'description' | 'discarded_at' | 'duration' | 'id' | 'name' | 'published' | 'streams' | 'updated_at' | 'validated', required — The key of Mixtape
  - `natural` boolean, nullable
  - `reverse` boolean, nullable
  - `soundex` boolean, nullable
- `type` string — The type of {name}<note><strong>standard</strong>: Mixtape default: créée/éditée directement comme une mixtape classique</note><note><strong>generated</strong>: Mixtape produite dynamiquement par une autre application</note><note><strong>composite</strong>: Mixtape qui référence d’autres mixtape</note>
- `validity` integer — The {name} validity duration (in seconds)
- `validity_strategy` string, nullable — The strategy to apply for validity adjustment<note><strong>only_increase</strong>: Only increases the {model} validity if the requested duration is greater than the current one</note><note><strong>only_decrease</strong>: Only decreases the {model} validity if the requested duration is less than the current one</note>
- `return` 'total'
- `page` integer
- `per_page` integer

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `total` integer — Total number of items Added when using query parameter `page`
  - `page` integer — Number of the current page Added when using query parameter `page`
  - `pages` integer — Total number of pages Added when using query parameter `page`
  - `items_per_page` integer — Number of items per page Added when using query parameter `page`

## Changes

- **2026-09-22** `f11860e74a00` — 2 info
  - for the `path` request parameter `channel`, the type was generalized from `integer` to `string`
  - removed `subschema #2` from the response body `allOf` list for the response status `200`

[Change history](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/changes/2/vod/channels/:channel/mixtapes/get.md)

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) · [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) · [OpenAPI document](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/revisions/64c14a5addb7?raw)