v1
latestOpenAPI 3.1.02026-07-2419782400.4 KBRetrieve assets
original is only returned for assets marked as public and requires the account to have the seoBaseUrl setting configured.
Query parameters
Brand id, can be retrieved using the Retrieve brands and subbrands call.
Sub-brand id, can be retrieved using the Retrieve brands and subbrands call.
Category id, can be retrieved using the Retrieve categories call.
Collection id, can be retrieved using the Retrieve collections call.
Asset id, will return the asset for that id.
Comma-separated list of asset ids. Will return an asset for each existing id.
Comma-separated list of (metaproperty) option ids, can be retrieved using the Retrieve metaproperties call.
Comma-separated list of tags, can be retrieved using the Retrieve tags call.
Comma-separated list of asset types.
Comma-separated list of asset orientation.
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.
Indicates whether or not the response should only contain assets marked as "limited usage".
Indicates whether or not the response should only contain archived assets.
Indicates whether or not the response should only contain assets marked as public.
Search on filenames, tags, extensions, collection names, guidelines, brandstore, campaigns in workflow, enriched PDFs, word documents.
Retrieve assets created after this date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
Set a date range together with the "dateCreated" parameter. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
Retrieve assets created on this specific date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
Retrieve assets modified after this date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
Set a date range together with the "dateModified" parameter. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
Retrieve assets modified on this specific date. ISO8601 format yyyy-mm-ddThh:mm:ssZ.
Order of the returned list of assets.
Maximum number of results.
Offset page for results: return the N-th set of limit-results.
Indicating whether or not the response should include count results.
Indicating whether or not the response should include the total count of results.
Indicating whether or not the response should include all the different media items (derivatives) available for each asset.
Indicating whether or not the response should include the active version number.
cursorMark returned in the X-Bynder-NextCursor response header which allows to return the next set of results.
Headers
OAuth 2.0 Bearer access token.
Response
Successful response