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

# Returns a list of deleted DAM Files

`GET /dam/files/deleted`

## Request

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

## Retrieve Deleted DAM Files
Endpoint for retrieving a collection deleted DAM Files.

## Query parameters

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

## Response `200`

success

- DeletedFilesCollection
  - `data` DeletedFile[]
    - `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` DeletedFileMeta, required
      - `deleted_at` string, date-time, nullable: UTC timestamp of deletion
      - `trashed_at` string, date-time, nullable: Always null once the file is deleted
  - `links` LinksDeleted
    - `first` string
    - `last` string
    - `prev` string, nullable
    - `next` string, nullable
  - `meta` MetaDeleted
    - `current_page` integer
    - `from` integer
    - `last_page` integer
    - `links` LinkDeleted[]
      - `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` 'deleted_at' | '-deleted_at': Echo of the sort query parameter; defaults to deleted_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)