---
title: "List and search media items"
method: GET
path: "/"
---

# List and search media items

`GET /`

Retrieve information about multiple media items with the ability to search and paginate.

## Query parameters

- `order` 'ascending' | 'descending'
- `page_index` integer
- `page_size` integer
- `start_time` string
- `end_time` string

## Response `200`

Successfully retrieved

- object
  - `_embedded` object — A collection of media items. See [retrieve a media item](#retrieve-a-media-item) for a description of the returned fields
    - `media` Media[]
      - `account_id` string — The ID of your Nexmo account. This is the same as your API key.
      - `etag` string — An identifier for the content. This will change if the content of the file has been changed (i.e. if you upload a new version of the file). For more information see Wikipedia: [HTTP ETag](https://en.wikipedia.org/wiki/HTTP_ETag)
      - `id` string — A UUID representing the object.
      - `max_downloads_allowed` integer — The maximum number of times the file may be downloaded.
      - `media_size` integer — The size of the file in bytes
      - `metadata_primary` string — A user set string containing metadata about the media file.
      - `metadata_secondary` string — A user set string containing further metadata about the media file.
      - `mime_type` string — The IETF MIME type of the file.
      - `original_file_name` string — The filename of the object as it was originally uploaded.
      - `public` boolean — Whether the item is available for download without authentication.
      - `store_id` string — An internal identifier of how the file is stored.
      - `time_created` string — A timestamp for the time that the file was created
      - `time_last_updated` string — A timestamp for the time that the file was last modified
      - `times_downloaded` integer — The number of times the file has been downloaded.
  - `_links` object
    - `first` object
      - `href` string
    - `last` object
      - `href` string
    - `self` object
      - `href` string
  - `count` integer — The total number of records returned by your request.
  - `page_index` integer — The `page_index` used in your request.
  - `page_size` integer — The amount of records returned in this response.

---

[API](https://skmtc.net/vonage/apis/media.md) · [All operations](https://skmtc.net/vonage/apis/media/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vonage/media/versions/6c4368740b66/schema)