Sign in

v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-214977372.7 KB
Digital Asset Management (DAM)

List and search assets

This API can list all the uploaded files and folders in your ImageKit.io media library. In addition, you can fine-tune your query by specifying various filters by generating a query string in a Lucene-like syntax and provide this generated string as the value of the searchQuery.

get/v1/files

Query parameters

type'file' | 'file-version' | 'folder' | 'all'

Filter results by asset type.

  • file — returns only files
  • file-version — returns specific file versions
  • folder — returns only folders
  • all — returns both files and folders (excludes file-version)
sort'ASC_NAME' | 'DESC_NAME' | 'ASC_CREATED' | 'DESC_CREATED' | 'ASC_UPDATED' | 'DESC_UPDATED' | 'ASC_HEIGHT' | 'DESC_HEIGHT' | 'ASC_WIDTH' | 'DESC_WIDTH' | 'ASC_SIZE' | 'DESC_SIZE' | 'ASC_RELEVANCE' | 'DESC_RELEVANCE'

Sort the results by one of the supported fields in ascending or descending order.

pathstring

Folder path if you want to limit the search within a specific folder. For example, /sales-banner/ will only search in folder sales-banner.

Note : If your use case involves searching within a folder as well as its subfolders, you can use path parameter in searchQuery with appropriate operator. Checkout Supported parameters for more information.

searchQuerystring

Query string in a Lucene-like query language e.g. createdAt > "7d".

Note : When the searchQuery parameter is present, the following query parameters will have no effect on the result:

  1. tags
  2. type
  3. name

Learn more from examples.

fileType'all' | 'image' | 'non-image'

Filter results by file type.

  • all — include all file types
  • image — include only image files
  • non-image — include only non-image files (e.g., JS, CSS, video)
limitinteger

The maximum number of results to return in response.

skipinteger

The number of results to skip before returning results.

Response

List of assets.