---
title: "Get screens for a field"
method: GET
path: "/rest/api/2/field/{fieldId}/screens"
tags: ["Screens"]
---

# Get screens for a field

`GET /rest/api/2/field/{fieldId}/screens`

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/api/2/field/{fieldId}/screens`
- Auth: one of:
  - HTTP basic
  - OAuth 2 (authorization code, authorization URL `https://auth.atlassian.com/authorize`, token URL `https://auth.atlassian.com/oauth/token`, scopes: `manage:jira-project`)
  - none

Returns a [paginated](#pagination) list of the screens a field is used in.

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

## Path parameters

- `fieldId` string, required

## Query parameters

- `startAt` integer
- `maxResults` integer
- `expand` string

## Response `200`

Returned if the request is successful.

- PageBeanScreenWithTab: 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` ScreenWithTab[]: The list of items.
    - `description` string: The description of the screen.
    - `id` integer: The ID of the screen.
    - `name` string: The name of the screen.
    - `scope` Scope: The projects the item is associated with. Indicated for items associated with [next-gen projects](https://confluence.atlassian.com/x/loMyO).
      - `project` ProjectDetails: Details about a project.
        - `avatarUrls` AvatarUrlsBean
          - `16x16` string, uri: The URL of the item's 16x16 pixel avatar.
          - `24x24` string, uri: The URL of the item's 24x24 pixel avatar.
          - `32x32` string, uri: The URL of the item's 32x32 pixel avatar.
          - `48x48` string, uri: The URL of the item's 48x48 pixel avatar.
        - `id` string: The ID of the project.
        - `key` string: The key of the project.
        - `name` string: The name of the project.
        - `projectCategory` UpdatedProjectCategory: A project category.
          - `description` string: The name of the project category.
          - `id` string: The ID of the project category.
          - `name` string: The description of the project category.
          - `self` string: The URL of the project category.
        - `projectTypeKey` 'software' | 'service_desk' | 'business' | 'product_discovery': The [project type](https://confluence.atlassian.com/x/GwiiLQ#Jiraapplicationsoverview-Productfeaturesandprojecttypes) of the project.
        - `self` string: The URL of the project details.
        - `simplified` boolean: Whether or not the project is simplified.
      - `type` 'PROJECT' | 'TEMPLATE': The type of scope.
    - `tab` ScreenableTab: A screen tab.
      - `id` integer: The ID of the screen tab.
      - `name` string, required: The name of the screen tab. The maximum length is 255 characters.

## Other responses

- `401`: Returned if the authentication credentials are incorrect or missing.
- `403`: Returned if the user does not have the necessary permission.

## Changes

- **2026-08-28** `38a98954789e`: 1 warning
  - added the new `product_discovery` enum value to the `values/items/scope/allOf[#/components/schemas/Scope]/project/allOf[#/components/schemas/ProjectDetails]/projectTypeKey` response property for the response status `200`

[Operation history](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/changes/rest/api/2/field/:fieldId/screens/get.md)

---

[API](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api.md) - [All operations](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/atlassian/apis/the-jira-cloud-platform-rest-api/revisions/5b336c497218?raw)