Retrieve assets

get

https://{your-bynder-domain}/api/v4/media/

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

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

brandId

uuid

Brand id, can be retrieved using the Retrieve brands and subbrands call.

subBrandId

uuid

Sub-brand id, can be retrieved using the Retrieve brands and subbrands call.

categoryId

uuid

Category id, can be retrieved using the Retrieve categories call.

collectionId

uuid

Collection id, can be retrieved using the Retrieve collections call.

id

uuid

Asset id, will return the asset for that id.

ids

string

Comma-separated list of asset ids. Will return an asset for each existing id.

propertyOptionId

string

Comma-separated list of (metaproperty) option ids, can be retrieved using the Retrieve metaproperties call.

tags

string

Comma-separated list of tags, can be retrieved using the Retrieve tags call.

type

string

enum

Comma-separated list of asset types.

Allowed:

orientation

string

enum

Comma-separated list of asset orientation.

Allowed:

property_NAME

string

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

Indicates whether or not the response should only contain assets marked as "limited usage".

archive

boolean

Indicates whether or not the response should only contain archived assets.

isPublic

boolean

Indicates whether or not the response should only contain assets marked as public.

keyword

string

Search on filenames, tags, extensions, collection names, guidelines, brandstore, campaigns in workflow, enriched PDFs, word documents.

dateCreated

date-time

Retrieve assets created after this date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.

dateCreatedTo

date-time

Set a date range together with the "dateCreated" parameter. ISO8601 format yyyy-mm-ddThh:mm:ssZ.

dateCreatedOn

date-time

Retrieve assets created on this specific date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.

dateModified

date-time

Retrieve assets modified after this date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.

dateModifiedTo

date-time

Set a date range together with the "dateModified" parameter. ISO8601 format yyyy-mm-ddThh:mm:ssZ.

dateModifiedOn

date-time

Retrieve assets modified on this specific date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.

orderBy

string

enum

Order of the returned list of assets.

limit

integer

≤ 1000

Defaults to 50

Maximum number of results.

page

integer

Defaults to 1

Offset page for results: return the N-th set of limit-results.

count

boolean

Defaults to false

Indicating whether or not the response should include count results.

total

boolean

Defaults to false

Indicating whether or not the response should include the total count of results.

includeMediaItems

boolean

Defaults to false

Indicating whether or not the response should include all the different media items (derivatives) available for each asset.

includeVersionNumber

boolean

Defaults to false

Indicating whether or not the response should include the active version number.

cursor

string

cursorMark returned in the X-Bynder-NextCursor response header which allows to return the next set of results.

Headers

Authorization

string

required

OAuth 2.0 Bearer access token.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json