---
title: "List Soft-Deleted Tabulars"
method: GET
path: "/management/v1/warehouse/{warehouse_id}/deleted-tabulars"
tags: ["warehouse"]
---

# List Soft-Deleted Tabulars

`GET /management/v1/warehouse/{warehouse_id}/deleted-tabulars`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/management/v1/warehouse/{warehouse_id}/deleted-tabulars`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/docs/management/v1/warehouse/:warehouse_id/deleted-tabulars/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all soft-deleted tables and views in the warehouse that are visible to the current user.

## Path parameters

- `warehouse_id` string, uuid, required

## Query parameters

- `namespaceId` string, uuid
- `pageToken` string, nullable
- `pageSize` integer, nullable

## Response `200`

List of soft-deleted tabulars

- ListDeletedTabularsResponse
  - `next-page-token` string, nullable: Token to fetch the next page
  - `tabulars` DeletedTabularResponse[], required: List of tabulars
    - `created-at` string, date-time, required: Date when the tabular was created
    - `deleted-at` string, date-time, required: Date when the tabular was deleted
    - `expiration-date` string, date-time, required: Date when the tabular will not be recoverable anymore
    - `id` string, uuid, required: Unique identifier of the tabular
    - `name` string, required: Name of the tabular
    - `namespace` string[], required: List of namespace parts the tabular belongs to
    - `typ` 'table' | 'view' | 'generic-table', required: Type of tabular
    - `warehouse-id` string, uuid, required: Warehouse ID where the tabular is stored

## Other responses

- `4XX`

---

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