---
title: "Retrieve asset download location"
method: GET
path: "/api/v4/media/{id}/download"
tags: ["Media download"]
---

# Retrieve asset download location

`GET /api/v4/media/{id}/download`

## Request

- Base URL: `https://{your-bynder-domain}`
- URL: `https://{your-bynder-domain}/api/v4/media/{id}/download`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://{your-auth-url}`
    - Client credentials
    - Token URL: `https://{your-bynder-domain}/v6/authentication/oauth2/token` scopes: `MEDIAHIGHRES`, `ARCHIVEDOWNLOAD`, `DOWNLOADWATERMARK`, `KEYVISUALSDOWNLOAD`
  - API key in header `Authorization`

Retrieve the download location for an asset.
__Warning:__ Requires the MEDIAHIGHRES security role.
__Warning:__ Requires the ARCHIVEDOWNLOAD security role if the asset in question is archived.
__Warning:__ Requires the DOWNLOADWATERMARK security role if the asset in question is watermarked.
__Warning:__ Requires the KEYVISUALSDOWNLOAD security role if the asset in question is marked as limited usage.

## Path parameters

- `id` string, required

## Query parameters

- `type` 'original' | 'additional'

## Response `200`

URL from which you can download the requested asset file.

- object
  - `disclaimer` string
  - `s3_file` string

## Other responses

- `400`: Invalid type
- `404`: Original file not available

---

[API](https://skmtc.dev/bynder/apis/download-api.md) - [All operations](https://skmtc.dev/bynder/apis/download-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bynder/apis/download-api/revisions/4ea32e479f26?raw)