---
title: "Retrieve specific asset"
url: "https://earlyaccess.developers.bynder.com/apis/asset-management-api-1/versions/b623ec0a-a559-4667-a0ee-28fa2b9cd7ce/paths/api-v4-media-id/get"
---

> Full API specification: https://earlyaccess.developers.bynder.com/apis/asset-management-api-1/versions/b623ec0a-a559-4667-a0ee-28fa2b9cd7ce.md

# Retrieve specific asset

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

Requires the **STATISTICS** security role in order to retrieve *views* and *downloads* statistics data in the response, using the `stats` parameter.

## Path parameters

- `id` (string, required) - Asset id.

## Query parameters

- `versions` (boolean, optional) - Include information about the different asset media items including versions.
- `stats` (boolean, optional) - Include information about *views* and *downloads*.

## Header parameters

- `Authorization` (string, required) - OAuth 2.0 Bearer access token.

## Responses

- `200` - Successful response
- `404` - File not found

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Asset Management API
  version: 1.0.0
servers:
  - url: https://{your-bynder-domain}/
paths:
  /api/v4/media/{id}:
    get:
      description: Requires the **STATISTICS** security role in order to retrieve
        *views* and *downloads* statistics data in the response, using the
        `stats` parameter.
      parameters:
        - description: OAuth 2.0 Bearer access token.
          in: header
          name: Authorization
          required: true
          schema:
            type: string
        - description: Asset id.
          in: path
          name: id
          required: true
          schema:
            type: string
        - description: Include information about the different asset media items including
            versions.
          in: query
          name: versions
          schema:
            default: false
            type: boolean
        - description: Include information about *views* and *downloads*.
          in: query
          name: stats
          schema:
            default: false
            type: boolean
      responses:
        "200":
          content:
            application/json:
              schema:
                properties:
                  activeOriginalFocusPoint:
                    properties:
                      x:
                        type: integer
                      y:
                        type: integer
                    type: object
                  archive:
                    type: boolean
                  brandId:
                    format: uuid
                    type: string
                  copyright:
                    type: string
                  dateCreated:
                    format: date-time
                    type: string
                  dateModified:
                    format: date-time
                    type: string
                  datePublished:
                    format: date-time
                    type: string
                  description:
                    type: string
                  downloads:
                    type: integer
                  extension:
                    items:
                      type: string
                    type: array
                  fileSize:
                    type: integer
                  height:
                    type: integer
                  id:
                    format: uuid
                    type: string
                  idHash:
                    type: string
                  isPublic:
                    type: boolean
                  limited:
                    type: boolean
                  name:
                    type: string
                  orientation:
                    type: string
                  original:
                    type: string
                  propertyOptions:
                    items:
                      type: string
                    type: array
                  property_assettype:
                    items:
                      type: string
                    type: array
                  relatedAssets:
                    items:
                      properties:
                        assets:
                          items:
                            type: string
                          type: array
                        metaPropertyId:
                          type: string
                        metaPropertyName:
                          type: string
                      type: object
                    type: array
                  tags:
                    items:
                      type: string
                    type: array
                  thumbnails:
                    properties:
                      mini:
                        type: string
                      thul:
                        type: string
                      webimage:
                        type: string
                    type: object
                  transformBaseUrl:
                    type: string
                  type:
                    type: string
                  userCreated:
                    type: string
                  videoPreviewURLs:
                    items:
                      type: string
                    type: array
                  views:
                    type: integer
                  watermarked:
                    type: boolean
                  width:
                    type: integer
                type: object
          description: Successful response
        "404":
          content:
            application/json:
              schema:
                properties:
                  message:
                    type: string
                  statuscode:
                    type: string
                type: object
          description: File not found
      security:
        - permanentToken:
            - ""
            - STATISTICS
        - OAuth2:
            - ""
            - STATISTICS
      summary: Retrieve specific asset
      tags:
        - Media ID
security:
  - permanentToken:
      - ""
      - STATISTICS
  - OAuth2:
      - ""
      - STATISTICS
components:
  securitySchemes:
    permanentToken:
      in: header
      name: Authorization
      type: apiKey
    OAuth2:
      flows:
        authorizationCode:
          authorizationUrl: https://{your-auth-url}
          scopes:
            ARCHIVEDOWNLOAD: ""
            ARCHIVEMEDIA: ""
            EMARGOMEDIA: ""
            KEYVISUALDOWNLOAD: ""
            MARKPUBLIC: ""
            MEDIAEDIT: ""
            MEDIAREMOVE: ""
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
        clientCredentials:
          scopes:
            ARCHIVEDOWNLOAD: ""
            ARCHIVEMEDIA: ""
            EMARGOMEDIA: ""
            KEYVISUALDOWNLOAD: ""
            MARKPUBLIC: ""
            MEDIAEDIT: ""
            MEDIAREMOVE: ""
            STATISTICS: ""
          tokenUrl: https://{your-bynder-domain}/v6/authentication/oauth2/token
      type: oauth2
```