---
title: "Get fields in trash paginated"
method: GET
path: "/rest/api/2/field/search/trashed"
tags: ["Issue fields"]
---

# Get fields in trash paginated

`GET /rest/api/2/field/search/trashed`

Returns a [paginated](#pagination) list of fields in the trash. The list may be restricted to fields whose field name or description partially match a string.

Only custom fields can be queried, `type` must be set to `custom`.

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg).

## Query parameters

- `startAt` integer
- `maxResults` integer
- `id` string[]
- `query` string
- `expand` 'name' | '-name' | '+name' | 'trashDate' | '-trashDate' | '+trashDate' | 'plannedDeletionDate' | '-plannedDeletionDate' | '+plannedDeletionDate' | 'projectsCount' | '-projectsCount' | '+projectsCount'
- `orderBy` string

## Response `200`

Returned if the request is successful.

- PageBeanField — A page of items.
  - `isLast` boolean — Whether this is the last page.
  - `maxResults` integer — The maximum number of items that could be returned.
  - `nextPage` string, uri — If there is another page of results, the URL of the next page.
  - `self` string, uri — The URL of the page.
  - `startAt` integer — The index of the first item returned.
  - `total` integer — The number of items returned.
  - `values` Field[] — The list of items.
    - `contextsCount` integer — Number of contexts where the field is used.
    - `description` string — The description of the field.
    - `id` string, required — The ID of the field.
    - `isLocked` boolean — Whether the field is locked.
    - `isUnscreenable` boolean — Whether the field is shown on screen or not.
    - `key` string — The key of the field.
    - `lastUsed` FieldLastUsed — Information about the most recent use of a field.
      - `type` 'TRACKED' | 'NOT_TRACKED' | 'NO_INFORMATION' — Last used value type: * *TRACKED*: field is tracked and a last used date is available. * *NOT\_TRACKED*: field is not tracked, last used date is not available. * *NO\_INFORMATION*: field is tracked, but no last used date is available.
      - `value` string, date-time — The date when the value of the field last changed.
    - `name` string, required — The name of the field.
    - `projectsCount` integer — Number of projects where the field is used.
    - `schema` JsonTypeBean, required — The schema of a field.
      - `configuration` object — If the field is a custom field, the configuration of the field.
      - `custom` string — If the field is a custom field, the URI of the field.
      - `customId` integer — If the field is a custom field, the custom ID of the field.
      - `items` string — When the data type is an array, the name of the field items within the array.
      - `system` string — If the field is a system field, the name of the field.
      - `type` string, required — The data type of the field.
    - `screensCount` integer — Number of screens where the field is used.
    - `searcherKey` string — The searcher key of the field. Returned for custom fields.
    - `stableId` string — The stable ID of the field.
    - `translatedDescription` string — The translated (i18n) description of the field for the current locale. Returned for custom fields.
    - `translatedName` string — The translated (i18n) name of the field for the current locale. Returned for custom fields.
    - `typeDisplayName` string — The display name of the field type

## Other responses

- `400` — Returned if the request is invalid.
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the necessary permission.

---

[API](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/versions/a26541c2f8bd/schema)