---
title: "Get media download URL"
method: GET
path: "/media/v1/download/{id}"
tags: ["Media"]
---

# Get media download URL

`GET /media/v1/download/{id}`

## Path parameters

- `id` string, required

## Query parameters

- `token` string, required
- `download_as_attachment_name` string
- `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV'

## Response `200`

A successful response.

- S12MediaV1SignedURLResponse
  - `url` string — The url has been deprecated for upload paths. For download paths, it is still valid. The signed URL that can be used to upload or download the media to the S12 system. UploadSignedURL is only valid for 5 minutes and DownloadSignedURL for 20 minutes; this is from the first bytes received i.e. if upload started within 5 minutes, it is still valid even if upload takes 10 minutes to complete. It is safe to reject a signed URL and re-request a new Upload/Download Signed URL.
  - `upload_info` S12MediaV1Upload
    - `multipart_upload` S12MediaV1UploadMultipartUpload
      - `upload_id` string — This parameter is the upload id generated by S3 when initiating a new multipart upload Used as an identifier of a multipart upload session
      - `upload_bodies` S12MediaV1UploadMultipartUploadUploadPartBody[]
        - `url` string — Destination url to upload the part
        - `part_number` string, int64 — Number of the part in the multipart uploading sequence
  - `download_info` S12MediaV1Download
    - `stream_info` S12MediaV1DownloadStream
      - `stream_url` string — URL to the HLS manifest file, used to start the streaming
      - `cookies` string[] — List of cookies to be used when requesting resource from CloudFront.
    - `mp4_info` S12MediaV1DownloadMP4
      - `url` string — Signed url to download the MP4 file
      - `captions_url` string — Signed url to download the captions file for the video

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)