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

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

# Retrieve assets

`GET` `/api/v4/media/`

`original` is only returned for assets marked as public and requires the account to have the `seoBaseUrl` setting configured.

## Query parameters

- `brandId` (string, uuid, optional) - Brand id, can be retrieved using the Retrieve brands and subbrands call.
- `subBrandId` (string, uuid, optional) - Sub-brand id, can be retrieved using the Retrieve brands and subbrands call.
- `categoryId` (string, uuid, optional) - Category id, can be retrieved using the Retrieve categories call.
- `collectionId` (string, uuid, optional) - Collection id, can be retrieved using the Retrieve collections call.
- `id` (string, uuid, optional) - Asset id, will return the asset for that id.
- `ids` (string, optional) - Comma-separated list of asset ids. Will return an asset for each existing id.
- `propertyOptionId` (string, optional) - Comma-separated list of (metaproperty) option ids, can be retrieved using the Retrieve metaproperties call.
- `tags` (string, optional) - Comma-separated list of tags, can be retrieved using the Retrieve tags call.
- `type` (string, optional) - Comma-separated list of asset types.
- `orientation` (string, optional) - Comma-separated list of asset orientation.
- `property_NAME` (string, optional) - Metaproperty option name or comma-separated list ids of metaproperty options for that metaproperty. Beware that NAME should be replaced with the actual metaproperty name. This is an AND operation when passing multiple values. If a Date type metaproperty is added, retrieving assets using the dates for that metaproperty is not supported.
- `limited` (boolean, optional) - Indicates whether or not the response should only contain assets marked as "limited usage".
- `archive` (boolean, optional) - Indicates whether or not the response should only contain archived assets.
- `isPublic` (boolean, optional) - Indicates whether or not the response should only contain assets marked as public.
- `keyword` (string, optional) - Search on filenames, tags, extensions, collection names, guidelines, brandstore, campaigns in workflow, enriched PDFs, word documents.
- `dateCreated` (string, date-time, optional) - Retrieve assets created after this date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
- `dateCreatedTo` (string, date-time, optional) - Set a date range together with the "dateCreated" parameter. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
- `dateCreatedOn` (string, date-time, optional) - Retrieve assets created on this specific date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
- `dateModified` (string, date-time, optional) - Retrieve assets modified after this date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
- `dateModifiedTo` (string, date-time, optional) - Set a date range together with the "dateModified" parameter. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
- `dateModifiedOn` (string, date-time, optional) - Retrieve assets modified on this specific date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
- `orderBy` (string, optional) - Order of the returned list of assets.
- `limit` (integer, optional) - Maximum number of results.
- `page` (integer, optional) - Offset page for results: return the N-th set of limit-results.
- `count` (boolean, optional) - Indicating whether or not the response should include count results.
- `total` (boolean, optional) - Indicating whether or not the response should include the total count of results.
- `includeMediaItems` (boolean, optional) - Indicating whether or not the response should include all the different media items (derivatives) available for each asset.
- `includeVersionNumber` (boolean, optional) - Indicating whether or not the response should include the active version number.
- `cursor` (string, optional) - cursorMark returned in the X-Bynder-NextCursor response header which allows to return the next set of results.

## Header parameters

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

## Responses

- `200` - Successful response
- `404` - 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/:
    get:
      description: >
        `original` is only returned for assets marked as public and requires the
        account to have the `seoBaseUrl` setting configured.
      parameters:
        - description: OAuth 2.0 Bearer access token.
          in: header
          name: Authorization
          required: true
          schema:
            type: string
        - description: Brand id, can be retrieved using the Retrieve brands and subbrands
            call.
          in: query
          name: brandId
          schema:
            format: uuid
            type: string
        - description: Sub-brand id, can be retrieved using the Retrieve brands and
            subbrands call.
          in: query
          name: subBrandId
          schema:
            format: uuid
            type: string
        - description: Category id, can be retrieved using the Retrieve categories call.
          in: query
          name: categoryId
          schema:
            format: uuid
            type: string
        - description: Collection id, can be retrieved using the Retrieve collections call.
          in: query
          name: collectionId
          schema:
            format: uuid
            type: string
        - description: Asset id, will return the asset for that id.
          in: query
          name: id
          schema:
            format: uuid
            type: string
        - description: Comma-separated list of asset ids. Will return an asset for each
            existing id.
          in: query
          name: ids
          schema:
            type: string
        - description: Comma-separated list of (metaproperty) option ids, can be retrieved
            using the Retrieve metaproperties call.
          in: query
          name: propertyOptionId
          schema:
            type: string
        - description: Comma-separated list of tags, can be retrieved using the Retrieve
            tags call.
          in: query
          name: tags
          schema:
            type: string
        - description: Comma-separated list of asset types.
          in: query
          name: type
          schema:
            enum:
              - image
              - document
              - audio
              - video
              - 3d
            type: string
        - description: Comma-separated list of asset orientation.
          in: query
          name: orientation
          schema:
            enum:
              - square
              - portrait
              - landscape
            type: string
        - description: Metaproperty option name or comma-separated list ids of
            metaproperty options for that metaproperty. Beware that NAME should
            be replaced with the actual metaproperty name. This is an AND
            operation when passing multiple values. If a Date type metaproperty
            is added, retrieving assets using the dates for that metaproperty is
            not supported.
          in: query
          name: property_NAME
          schema:
            type: string
        - description: Indicates whether or not the response should only contain assets
            marked as "limited usage".
          in: query
          name: limited
          schema:
            type: boolean
        - description: Indicates whether or not the response should only contain archived
            assets.
          in: query
          name: archive
          schema:
            type: boolean
        - description: Indicates whether or not the response should only contain assets
            marked as public.
          in: query
          name: isPublic
          schema:
            type: boolean
        - description: Search on filenames, tags, extensions, collection names,
            guidelines, brandstore, campaigns in workflow, enriched PDFs, word
            documents.
          in: query
          name: keyword
          schema:
            type: string
        - description: Retrieve assets created after this date. ISO8601 format
            yyyy-mm-ddThh:mm:ssZ.
          in: query
          name: dateCreated
          schema:
            format: date-time
            type: string
        - description: Set a date range together with the "dateCreated" parameter. ISO8601
            format yyyy-mm-ddThh:mm:ssZ.
          in: query
          name: dateCreatedTo
          schema:
            format: date-time
            type: string
        - description: Retrieve assets created on this specific date. ISO8601 format
            yyyy-mm-ddThh:mm:ssZ.
          in: query
          name: dateCreatedOn
          schema:
            format: date-time
            type: string
        - description: Retrieve assets modified after this date. ISO8601 format
            yyyy-mm-ddThh:mm:ssZ.
          in: query
          name: dateModified
          schema:
            format: date-time
            type: string
        - description: Set a date range together with the "dateModified" parameter.
            ISO8601 format yyyy-mm-ddThh:mm:ssZ.
          in: query
          name: dateModifiedTo
          schema:
            format: date-time
            type: string
        - description: Retrieve assets modified on this specific date. ISO8601 format
            yyyy-mm-ddThh:mm:ssZ.
          in: query
          name: dateModifiedOn
          schema:
            format: date-time
            type: string
        - description: Order of the returned list of assets.
          in: query
          name: orderBy
          schema:
            enum:
              - dateCreated asc
              - dateModified asc
              - datePublished asc
              - name asc
              - dateCreated desc
              - dateModified desc
              - datePublished desc
              - name desc
            type: string
        - description: Maximum number of results.
          in: query
          name: limit
          schema:
            default: 50
            maximum: 1000
            type: integer
        - description: |
            Offset page for results: return the N-th set of limit-results.
          in: query
          name: page
          schema:
            default: 1
            type: integer
        - description: Indicating whether or not the response should include count results.
          in: query
          name: count
          schema:
            default: false
            type: boolean
        - description: Indicating whether or not the response should include the total
            count of results.
          in: query
          name: total
          schema:
            default: false
            type: boolean
        - description: Indicating whether or not the response should include all the
            different media items (derivatives) available for each asset.
          in: query
          name: includeMediaItems
          schema:
            default: false
            type: boolean
        - description: Indicating whether or not the response should include the active
            version number.
          in: query
          name: includeVersionNumber
          schema:
            default: false
            type: boolean
        - description: cursorMark returned in the X-Bynder-NextCursor response header
            which allows to return the next set of results.
          in: query
          name: cursor
          schema:
            type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  properties:
                    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
                    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
                    mediaItems:
                      items:
                        properties:
                          name:
                            type: string
                          publicUrl:
                            type: string
                          type:
                            type: string
                        type: object
                      type: array
                    name:
                      type: string
                    orientation:
                      type: string
                    original:
                      type: string
                    propertyOptions:
                      items:
                        type: string
                      type: array
                    property_limitedrights:
                      type: string
                    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
                    watermarked:
                      type: boolean
                    width:
                      type: integer
                  type: object
                type: array
          description: Successful response
          headers:
            X-Bynder-NextCursor:
              description: SOLR nextCursorMark which can be used to return the next X number
                of results. Returned when solr-cursor account feature is
                enabled.
              schema:
                type: string
        "404":
          content:
            application/json:
              schema:
                properties:
                  message:
                    type: string
                  statuscode:
                    type: string
                type: object
          description: Not Found
      security:
        - permanentToken:
            - ""
            - ARCHIVEMEDIA
            - ARCHIVEDOWNLOAD
            - EMARGOMEDIA
            - KEYVISUALDOWNLOAD
        - OAuth2:
            - ""
            - ARCHIVEMEDIA
            - ARCHIVEDOWNLOAD
            - EMARGOMEDIA
            - KEYVISUALDOWNLOAD
      summary: Retrieve assets
      tags:
        - Media
security:
  - permanentToken:
      - ""
      - ARCHIVEMEDIA
      - ARCHIVEDOWNLOAD
      - EMARGOMEDIA
      - KEYVISUALDOWNLOAD
  - OAuth2:
      - ""
      - ARCHIVEMEDIA
      - ARCHIVEDOWNLOAD
      - EMARGOMEDIA
      - KEYVISUALDOWNLOAD
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
```