---
title: "Get Media Files"
method: GET
path: "/v0/media_files"
tags: ["Media"]
---

# Get Media Files

`GET /v0/media_files`

Search media files by various parameters.

## Query parameters

- `vehicle_serial` string — Limit results to a specific vehicle, by serial number
- `flight_id` string, uuid — Limit results to a specific flight ID. ID can be formatted as a full UUID, or can omit `-` characters, and is case insensitive
- `kind` string[] — Filter by media type: `vehicleImage` - Images captured in flight `vehicleImageDng` - DNG images captured in flight `vehicleVideoPreview ` - LRV Recording of the full flight `vehicleVideoRaw` - Video recording of the flight when the vehicle was in “video mode”. (Not recorded when the vehicle is in “photo mode”). `videoTelemetryCsv` - CSV file with telemetry aligned to the vehicleVideoRaw
- `captured_before` string, date-time — Search for Media Files captured before this timestamp. The timestamp should follow the ISO 8601 standard format.
- `captured_since` string, date-time — Search for Media Files captured since this timestamp. The timestamp should follow the ISO 8601 standard format.
- `uploaded_before` string, date-time — Search for Media Files uploaded before this timestamp. The timestamp should follow the ISO 8601 standard format.
- `uploaded_since` string, date-time — Search for Media Files uploaded since this timestamp. The timestamp should follow the ISO 8601 standard format.
- `pre_signed_download_urls` boolean — If True, the media download urls will be pre-signed, will not require authentication, and will expire after 1 hour. If False, the urls will redirect to the file and will not expire, but will still require authentication.
- `mission_template_uuid` string, uuid — Limit results to a specific mission template ID (UUID)
- `mission_waypoint_name` string
- `per_page` integer — Number of results to return per page
- `page_number` integer — Return a specific page number from results

## Response `200`

List of media files returned from GET /media_files endpoint

- object
  - `data` object, required — List of media files returned from GET /media_files endpoint
    - `files` object[], required
      - `captured_time` string, date-time
      - `download_url` string
      - `filename` string, required
      - `flight_id` string
      - `kind` 'detectionImage' | 'detectionVideoClip' | 'vehicleImage' | 'vehicleImageDng' | 'vehicleIrImage' | 'vehicleRadiometricImage' | 'vehicleVideoPreview' | 'vehicleVideoRaw' | 'videoTelemetryCsv', required
      - `mission_template_uuid` string
      - `mission_waypoint_name` string — The name of the waypoint where the media was captured.
      - `sha256` string
      - `size` integer — File size in bytes
      - `uploaded_time` string, date-time
      - `user_id` string
      - `uuid` string, required
    - `pagination` object, required
      - `current_page` integer, required — Current page number of results
      - `max_per_page` integer, required — Maximum number of entries per page, could be less for final page
      - `total_pages` integer, required — Total pages of results
  - `error_message` string
  - `meta` object, required
    - `time` number
  - `skydio_error_code` integer, required
  - `status_code` integer, required

---

[API](https://skmtc.net/skydio/apis/skydio-cloud-api.md) · [All operations](https://skmtc.net/skydio/apis/skydio-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skydio/skydio-cloud-api/versions/0f746b116483/schema)