---
title: "List media shares."
method: GET
path: "/2/vod/media/{media}/shares"
tags: ["V3 > Share"]
---

# List media shares.

`GET /2/vod/media/{media}/shares`

Retrieves a paginated list of shares associated with the provided media based on the parameters.

## Path parameters

- `media` string, required

## Query parameters

- `expired_since` string, nullable — The expiry interval in the past
- `expires_in` string, nullable — The expiry interval in the future
- `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`

---

[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/158a854b0c7d/schema)