---
title: "List file assets"
method: GET
path: "/v1/assets"
tags: ["Assets"]
---

# List file assets

`GET /v1/assets`

Returns a paginated list of file assets. Supports filtering by parent folder and choosing between direct children or the entire folder subtree.

## Query parameters

- `parent_folder_id` integer
- `direct_descendants_only` boolean
- `page` integer
- `limit` integer

## Response `200`

A paginated list of file assets with metadata.

- object
  - `assets` AssetFile[] — The list of file assets matching the query.
    - `id` integer — The unique identifier of the file asset.
    - `name` string — The display name of the file asset.
    - `parent_folder_id` integer, nullable — The ID of the parent folder, or null if the asset is at the root level.
    - `path` string — The storage URL or path where the file is hosted.
    - `size` integer — The file size in bytes.
    - `created` integer — Unix timestamp when the asset was created.
    - `updated` integer — Unix timestamp when the asset was last updated.
  - `meta` ListMeta — Metadata about the paginated response including pagination details and applied filters.
    - `pagination` object — Pagination details for the current result set.
      - `page` integer — The current page number.
      - `limit` integer — The maximum number of results per page.
      - `total` integer — The total number of matching results across all pages.
    - `filters` object — The filters that were applied to the query.
      - `parent_folder_id` integer, nullable — The parent folder ID filter that was applied, or null if not filtering by parent.
      - `direct_descendants_only` boolean — Whether the results were limited to direct descendants only.

## Other responses

- `400` — Bad request
- `401` — Unauthorized - missing or invalid API key
- `404` — Resource not found

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)