---
title: "Retrieve assets"
method: GET
path: "/api/v4/media/"
tags: ["Media"]
---

# 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
- `subBrandId` string, uuid
- `categoryId` string, uuid
- `collectionId` string, uuid
- `id` string, uuid
- `ids` string
- `propertyOptionId` string
- `tags` string
- `type` 'image' | 'document' | 'audio' | 'video' | '3d'
- `orientation` 'square' | 'portrait' | 'landscape'
- `property_NAME` string
- `limited` boolean
- `archive` boolean
- `isPublic` boolean
- `keyword` string
- `dateCreated` string, date-time
- `dateCreatedTo` string, date-time
- `dateCreatedOn` string, date-time
- `dateModified` string, date-time
- `dateModifiedTo` string, date-time
- `dateModifiedOn` string, date-time
- `orderBy` 'dateCreated asc' | 'dateModified asc' | 'datePublished asc' | 'name asc' | 'dateCreated desc' | 'dateModified desc' | 'datePublished desc' | 'name desc'
- `limit` integer
- `page` integer
- `count` boolean
- `total` boolean
- `includeMediaItems` boolean
- `includeVersionNumber` boolean
- `cursor` string

## Headers

- `Authorization` string, required

## Response `200`

Successful response

- object[]
  - `dateModified` string, date-time
  - `propertyOptions` string[]
  - `type` string
  - `brandId` string, uuid
  - `fileSize` integer
  - `id` string, uuid
  - `height` integer
  - `description` string
  - `idHash` string
  - `name` string
  - `tags` string[]
  - `orientation` string
  - `width` integer
  - `datePublished` string, date-time
  - `copyright` string
  - `extension` string[]
  - `userCreated` string
  - `dateCreated` string, date-time
  - `archive` boolean
  - `property_limitedrights` string
  - `watermarked` boolean
  - `limited` boolean
  - `isPublic` boolean
  - `thumbnails` object
    - `mini` string
    - `webimage` string
    - `thul` string
  - `transformBaseUrl` string
  - `videoPreviewURLs` string[]
  - `original` string
  - `mediaItems` object[]
    - `name` string
    - `publicUrl` string
    - `type` string

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/bynder/apis/oauth-2-0.md) · [All operations](https://skmtc.net/bynder/apis/oauth-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bynder/oauth-2-0/versions/bb9efc864ce1/schema)