---
title: "Retrieve specific asset item download location"
url: "https://earlyaccess.developers.bynder.com/apis/download-api-1/versions/db8ee3be-70cd-48de-aa00-e2e94ab0239a/paths/api-v4-media-id--download--itemId/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/download-api-1/versions/db8ee3be-70cd-48de-aa00-e2e94ab0239a.md

# Retrieve specific asset item download location

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

Retrieve the download location for a specific asset item. __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)
- `itemId` (string, required)

## Query parameters

- `hash` (boolean, optional)

## Responses

- `200` - URL from which you can download the requested asset file.

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Download API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/media/{id}/download/{itemId}:
    get:
      description: >
        Retrieve the download location for a specific asset item.

        __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.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            example: 00000000-0000-0000-0000000000000000
            type: string
        - in: path
          name: itemId
          required: true
          schema:
            example: 00000000-0000-0000-0000000000000000
            type: string
        - in: query
          name: hash
          required: false
          schema:
            default: false
            type: boolean
      responses:
        "200":
          content:
            application/json:
              schema:
                properties:
                  disclaimer:
                    example: <p>1. The photographs and video in the mediabank are to be used by
                      anyone and everyone.</p>
                    type: string
                  s3_file:
                    example: ___TEMPORARY_DOWNLOAD_URL___
                    type: string
                type: object
          description: URL from which you can download the requested asset file.
      summary: Retrieve specific asset item download location
      tags:
        - Media download
security:
  - OAuth2:
      - MEDIAHIGHRES
      - ARCHIVEDOWNLOAD
      - DOWNLOADWATERMARK
      - KEYVISUALSDOWNLOAD
  - permanentToken:
      - MEDIAHIGHRES
      - ARCHIVEDOWNLOAD
      - DOWNLOADWATERMARK
      - KEYVISUALSDOWNLOAD
components:
  securitySchemes:
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            ARCHIVEDOWNLOAD: ""
            DOWNLOADWATERMARK: ""
            KEYVISUALSDOWNLOAD: ""
            MEDIAHIGHRES: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            ARCHIVEDOWNLOAD: ""
            DOWNLOADWATERMARK: ""
            KEYVISUALSDOWNLOAD: ""
            MEDIAHIGHRES: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
```