---
title: "What is in the trash"
method: GET
path: "/api/v1/trash"
tags: ["Trash"]
---

# What is in the trash

`GET /api/v1/trash`

## Request

- Base URL: `https://api.roma.app`
- URL: `https://api.roma.app/api/v1/trash`
- Auth: HTTP bearer

The trash: everything soft-deleted in the last ~30 days — items and lists — newest first, each with the moment it is purged forever (purgesAt). Anything listed here can be brought back with restore_deleted. Filter by type, or omit `type` for both.

## Query parameters

- `type` 'item' | 'list': Only this kind. Omit for both.
- `limit` integer: Max entries per kind (default 25).

## Response `200`

The tool's result.

- object
  - `count` number, required
  - `items` object[], required
    - `type` 'item' | 'list', required
    - `id` string, required
    - `title` string, nullable, required
    - `deletedAt` string, required
    - `purgesAt` string, required
    - `listId` string, nullable
    - `listName` string, nullable

## Other responses

- `400`: The request was understood and refused; the error says what to change.
- `401`: No usable bearer token.
- `404`: No such item for this account.
- `405`: The path exists but not with this method; Allow lists the ones that work.
- `429`: Over the rate limit; wait for Retry-After.

---

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