---
title: "Returns a list of DAM Files within a folder"
method: GET
path: "/dam/folders/{folder_id}/files"
tags: ["DAM: Folders: Files"]
---

# Returns a list of DAM Files within a folder

`GET /dam/folders/{folder_id}/files`

## Request

- Base URL: `https://api.kontainer.com/jsonapi/v2`
- URL: `https://api.kontainer.com/jsonapi/v2/dam/folders/{folder_id}/files`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kontainer/apis/kontainer-api-documentation/docs/dam/folders/:folder_id/files/get.ts> (a function with typed inputs; its response is checked against the schema)

## Retrieve DAM Files
Endpoint for retrieving a collection of Files within a folder. Note that root folder and trash folder can not be listed.

## Path parameters

- `folder_id` string, required

## Query parameters

- `filter` object
- `page` number
- `pageSize` number
- `relationships` string
- `includes` string
- `meta[]` string[]

## Response `200`

success

- Files
  - `data` File[]
    - `type` 'file', required
    - `id` string, required
    - `attributes` FileAttributes, required
      - `name` string
      - `description` string, nullable
      - `size` integer: File size in bytes
      - `sort` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time, nullable
      - `extension` string
      - `width` integer, nullable: Width of the stored pixels, before EXIF orientation is applied
      - `height` integer, nullable: Height of the stored pixels, before EXIF orientation is applied
      - `orientation` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: EXIF orientation code (1-8). 1 when the file has no orientation tag. Codes 5-8 display with width and height swapped
      - `rotation` 0 | 90 | 180 | 270: Clockwise degrees the EXIF orientation turns the stored pixels to display them. 90 and 270 swap width and height
      - `version` integer
      - `is_archived` boolean
      - `hasDuplicates` boolean
      - `consent_status` string
      - `consent_rights` string[]
      - `consent_party_ids` integer[]
      - `consent_expire_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/kontainer/apis/kontainer-api-documentation.md) - [All operations](https://skmtc.dev/kontainer/apis/kontainer-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kontainer/apis/kontainer-api-documentation/revisions/b80a5167e09a?raw)