---
title: "Returns a list of trashed DAM Files"
method: GET
path: "/dam/files/trashed"
tags: ["DAM: Files"]
---

# Returns a list of trashed DAM Files

`GET /dam/files/trashed`

## Request

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

## Retrieve Trashed DAM Files
Endpoint for retrieving a collection trashed DAM Files.

## Query parameters

- `filter` object
- `page[number]` number
- `page[size]` number

## Response `200`

success

- TrashedFilesCollection
  - `data` TrashedFile[]
    - `type` 'file', required
    - `id` string, required
    - `attributes` RemovedFileAttributes, 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, nullable
      - `consent_rights` integer[]
      - `consent_party_ids` integer[]
      - `consent_expire_at` string, date-time, nullable
    - `links` RemovedFileLinks, required
      - `self` string, uri, required: URL of the file under its folder
      - `duplicates` string, uri: URL of the file's content duplicates. Only present for client admins with duplicate detection enabled, when the file has duplicates
    - `meta` TrashedFileMeta, required
      - `deleted_at` string, date-time, nullable: Always null for a trashed file
      - `trashed_at` string, date-time, nullable: UTC timestamp the file was moved to the trash
  - `links` LinksTrashed
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` MetaTrashed
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `links` LinkTrashed[]
      - `url` string, nullable
      - `label` string
      - `active` boolean
    - `path` string
    - `per_page` integer
    - `to` integer
    - `total` integer
    - `filter` union: The `filter` query parameter echoed back as sent; an empty array when none was sent
      - object
      - unknown[]
        - unknown
    - `sort` 'trashed_at' | '-trashed_at': Echo of the sort query parameter; defaults to trashed_at

## 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)