# Is there a way to list assets based on metadata, or collections as filter?

**URL:** <https://forum.frame.io/t/is-there-a-way-to-list-assets-based-on-metadata-or-collections-as-filter/3420>\
**Category:** Help\
**Created:** [July 15, 2026, 4:41pm UTC](https://forum.frame.io/t/is-there-a-way-to-list-assets-based-on-metadata-or-collections-as-filter/3420 "2026-07-15T16:41:49Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![musthafa](https://avatars.discourse-cdn.com/v4/letter/m/82dd89/32.png) [@musthafa](https://forum.frame.io/u/musthafa)\
**Post date:** [July 15, 2026, 4:41pm UTC](https://forum.frame.io/t/is-there-a-way-to-list-assets-based-on-metadata-or-collections-as-filter/3420/1 "2026-07-15T16:41:49Z")

</div>

I’m developing an app to upload media to social media posting app custom developed for own purpose. Im on V4, is there a way to list files under a collection or search files using more queries , either metadata or other filters?

---

<div class="post-metadata">

**Author:** ![rosiec](https://yyz1.discourse-cdn.com/flex035/user_avatar/forum.frame.io/rosiec/32/518_2.png) [@rosiec](https://forum.frame.io/u/rosiec)\
**Post date:** [July 21, 2026, 4:57pm UTC](https://forum.frame.io/t/is-there-a-way-to-list-assets-based-on-metadata-or-collections-as-filter/3420/2 "2026-07-21T16:57:51Z")

</div>

Hi @musthafa

You can use the search endpoint to filter based on metadata field values.

Here is the documentation for this endpoint: [Search account | Frame.io API Documentation](https://next.developer.frame.io/platform/api-reference/search/search)

Something to note here is that you can select between lexical and nlp search engines in your request. I’ve included examples requests for each below.

* * *

In this example, the text ‘fall photoshoot’ was added to an asset in the Notes metadata field.

```auto
curl -X POST https://api.frame.io/v4/accounts/:ACCOUNT_ID/search \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "engine": "lexical",
  "query": "fall photoshoot",
  "filters": {
    "files_and_version_stacks": true,
    "folders": false,
    "projects": false
  }
}'

```

* * *

```auto
curl -X POST https://api.frame.io/v4/accounts/:ACCOUNT_ID/search \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "engine": "nlp",
  "query": "all files with Admin in filename",
  "filters": {
    "files_and_version_stacks": true,
    "folders": false,
    "projects": false
  }
}'

```

* * *

If you already know where the files are and just want to list them instead of searching, you can use the **[List files](https://next.developer.frame.io/platform/api-reference/files/list)** or **[List folder children](https://next.developer.frame.io/platform/api-reference/folders/index)** endpoints. Both support `include=metadata` so you get the assets and their metadata back together.

If you just need a collection’s contents there are also **[List collections](https://next.developer.frame.io/platform/api-reference/collections/index)** and **[Show collection](https://next.developer.frame.io/platform/api-reference/collections/show)** endpoints worth checking.

I hope this helps!

---

<div class="post-metadata">

**Author:** ![musthafa](https://avatars.discourse-cdn.com/v4/letter/m/82dd89/32.png) [@musthafa](https://forum.frame.io/u/musthafa)\
**Post date:** [July 21, 2026, 5:48pm UTC](https://forum.frame.io/t/is-there-a-way-to-list-assets-based-on-metadata-or-collections-as-filter/3420/3 "2026-07-21T17:48:01Z")

</div>

I did a search, but the search uses a text based query term. is there a way to search for example:

status = approved? or filetype = mp4/mov etc ?