---
title: "Get your medias"
method: GET
path: "/v1/media"
tags: ["Media Files"]
---

# Get your medias

`GET /v1/media`

## Request

- Base URL: `https://api.dexatel.com`
- URL: `https://api.dexatel.com/v1/media`
- Auth: API key in header `X-Dexatel-Key`

## Query parameters

- `page_size` string: Default value is 10, can be at maximum 1000
- `page_token` string: Found in pagination links and can be used to get 'previous' or 'next' items

## Response `200`

OK

- MediaResponseListWrapperDto
  - `data` object[]
    - `id` string, uuid: The unique identifier assigned to a media file
    - `account_id` string, uuid: The unique identifier of the account
    - `file_name` string: The name of the media file
    - `status` 'pending' | 'uploaded' | 'in_use': The current state of a media file
    - `directory` 'temp' | 'perm': The directory setting determines how long files are stored. If set to TEMP, files are available for 3 months, while if set to PERM, files are available indefinitely
    - `type` 'image' | 'video' | 'document': The format of the media file
    - `content_type` string: Content type of the media file
    - `get_url` string: The URL used to get the media
    - `create_date` string, date-time: Creation date of the media file in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `update_date` string, date-time: Update date of the media file in UTC, formatted as yyyy-mm-dd hh:mm:ss
    - `thumbnail_url` string: The URL of thumbnail if the media file is in video format
  - `pagination` Pagination
    - `number` integer: Current page number
    - `size` integer: Page size. Default value is 10, can be at maximum 1000
    - `total` integer: Total count of requested resources
    - `links` object: Contains URLs to get next/previous resources
      - `first` string: URL to the first page
      - `current` string: URL to the current page
      - `previous` string: URL to the previous page, if any
      - `next` string: URL to the next page, if any

---

[API](https://skmtc.dev/dexatel/apis/miscellaneous.md) - [All operations](https://skmtc.dev/dexatel/apis/miscellaneous/llms.txt) - [OpenAPI document](https://skmtc.dev/dexatel/apis/miscellaneous/revisions/44500422bb80?raw)