---
title: "List deleted entity records"
method: GET
path: "/api/apps/{app_id}/entities/{entity_name}/trash"
---

# List deleted entity records

`GET /api/apps/{app_id}/entities/{entity_name}/trash`

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns the records deleted from one of the app's entities that are still in its trash.

A record lands here when [Delete entity record](/api-reference/delete-entity-record) removes it, and stays until you bring it back with [Restore entity record](/api-reference/restore-entity-record) or erase it with [Permanently delete entity record](/api-reference/permanently-delete-entity-record). Row-level security doesn't apply, so you get every deleted record in the entity. The `User` entity has no trash, because [Remove app user](/api-reference/remove-app-user) deletes a user outright, so asking for its trash returns a 404.

Filter, sort, and page the same way as [List entity records](/api-reference/list-entity-records), except that the 5000 record cap doesn't apply here: leave out `limit` to get the whole trash in one response.

<Note>This endpoint accepts a personal API key belonging to a user with editor access to the app. A read-only key is refused, and workspace API keys are not accepted.</Note>

## Path parameters

- `app_id` string, required — ID of the app that owns the entity.
- `entity_name` string, required — Name of the entity, exactly as [List entity schemas](/api-reference/list-entity-schemas) reports it. Don't pass `User` here. It doesn't fail, but it reads and writes a separate, disconnected set of records stored under that name, not the app's real user accounts, which are managed through their own endpoints.

## Query parameters

- `q` string
- `limit` integer
- `skip` integer
- `sort` string
- `fields` string

## Response `200`

The entity's deleted records.

- object[]
  - `id` string, nullable — ID of the record. Pass it as `entity_id` to [Get entity record](/api-reference/get-entity-record), [Update entity record](/api-reference/update-entity-record) or [Delete entity record](/api-reference/delete-entity-record).
  - `created_date` string, nullable — When the record was created, as a UTC timestamp in ISO 8601 format. A record Base44 has just created carries a `Z` suffix, and a record read back from storage does not.
  - `updated_date` string, nullable — When the record last changed, as a UTC timestamp in ISO 8601 format. A record Base44 has just created carries a `Z` suffix, and a record read back from storage does not.
  - `created_by` string, nullable — Email of the app user who created the record, or `anonymous` when a visitor created it on an app that needs no login. Apps that hide record authorship leave this field out of the response.
  - `created_by_id` string, nullable — ID of the app user who created the record, or `anonymous` when a visitor created it on an app that needs no login.
  - `is_sample` boolean, nullable — Whether Base44 stored the record as sample data while the app was being built. A record you create reports `false`.
  - `deleted_date` string, nullable — When the record was deleted, as a UTC timestamp in ISO 8601 format.

## Other responses

- `400` — `q` isn't a JSON object, `limit` or `skip` is out of range or not a whole number, or `sort` names more than one field.
- `401` — Missing or invalid credentials.
- `403` — You don't have editor access to this app, or your API key is read-only.
- `404` — App not found, the app has no entity with this name, or the entity is `User`.
- `422` — A filter you passed as its own query parameter doesn't match the type the entity's schema declares for that field.
- `429` — Rate limit exceeded. The base limit is 70 requests per minute. See [Rate limits](/developers/references/apps-api/get-started/rate-limits) for the multiplier your plan gets.

## Changes

> 18 revisions in range; 1 not diffed.

- **2026-09-28** `28fc82924122` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/apps/:app_id/entities/:entity_name/trash/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/28fc82924122?raw)