---
title: "List product players"
method: GET
path: "/1/radios/{radio_product_id}/players"
tags: ["Players"]
---

# List product players

`GET /1/radios/{radio_product_id}/players`

This endpoint allows you to retrieve all the players in a product.

## Path parameters

- `radio_product_id` integer, required

## Query parameters

- `with` string
- `type` string[] — Type of the resource `{name}`
- `return` 'total'
- `limit` integer
- `skip` integer
- `page` integer
- `per_page` integer
- `order_by` union
  - string
  - string[]
- `order` 'asc' | 'desc'
- `order_for` object

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required — Result of the HTTP request
  - `data` 0cc1b8a9Player[]
    - `display_name` string, required — Name of the ressource `Player` visible by final customer
    - `is_metadata_display` boolean, required — Is the metadata title and artist displayed?
    - `is_logo` boolean, required — Is the logo Infomaniak enabled?
    - `is_auto_start` boolean, required — Is the auto start enabled?
    - `volume` integer, required — The volume used in the `Player`
    - `language` 'de' | 'en' | 'es' | 'fr' | 'it', required — The language used in the `Player`
    - `height` number, required — The height used for render the `Player` (px)
    - `width` number, required — The width used for render the `Player` (px)
    - `button_color` string, required — The button color used in the `Player`
    - `background_color` string, required — The background color used in the `Player`
    - `secondary_color` string, required — The secondary color used in the `Player`
    - `thumbnail` string, required — The thumbnail url of the `Player`
    - `is_listeners` boolean, required — Is the listeners informations displayed?
    - `is_listeners_hold` boolean, required — Is the listeners hold displayed?
    - `listeners_hold` integer, required — The listeners hold used to display listeners informations
    - `is_embed` boolean, required — Is embed link visible?
    - `is_facebook_embed` boolean, required — Is the Facebook embed link visible?
    - `facebook_link` string — The Facebook link used to Facebook embed
    - `is_twitter_embed` boolean, required — Is the Twitter embed link visible?
    - `twitter_account` string — The Twitter account used to Twitter embed
    - `twitter_backlink` string — The Twitter backlink used to Twitter embed
    - `twitter_hashtag` string — The Twitter hashtag used to Twitter embed
    - `loading` string, required — The url of the loading file used in the player
    - `unavailable` string, required — The url of the unavailable file used in the player
    - `restriction` string, required — The url of the restriction file used in the player
    - `is_cover` boolean, required — Is the cover enabled?
    - `is_spectrum` boolean, required — Is the spectrum enabled?
    - `is_station_thumbnail` boolean, required — Is the station thumbnail used?
    - `is_hls_buffered` boolean, required — Is the player start at the beginning and buffer hls streams?
    - `is_direct_control` boolean, required — Is the player in direct control mode ?
    - `history_display` 'none' | 'overlay' | 'split' | 'under', required — The history display used in the `Player`
    - `history_hold` integer, required — The max song in the history
    - `is_history_time_display` boolean, required — Is the history player time will be display ?
    - `is_history_clickable` boolean, required — Is the history player could be clickable ?
    - `id` integer, required — Unique identifier of the resource `Player`
    - `uuid` string, required — Universally unique identifier of the resource `Player`
    - `name` string, required — Name of the resource `Player`
    - `type` integer, required — Type of the resource `Player`
    - `iframe` string, required — The iframe to integrate the `Player`
    - `stations` unknown[]
      - unknown
    - `domains` string, required — The list of domains allow to access
    - `created_at` integer, required — Timestamp `Player` has been created
    - `updated_at` integer, required — Timestamp `Player` has been updated
  - `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`

## Other responses

- `404` — Not Found

---

[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-service-production.skmtc.workers.dev/v1/apis/infomaniak/api-reference-developer-tools/revisions/667aae28fec6/schema)