---
title: "Get fields for projects"
method: GET
path: "/rest/api/3/projects/fields"
tags: ["Issue fields"]
---

# Get fields for projects

`GET /rest/api/3/projects/fields`

Returns a [paginated](#pagination) list of fields for the requested projects and work types.

Only fields that are available for the specified combination of projects and work types are returned. This endpoint allows filtering to specific fields if field IDs are provided.

**[Permissions](#permissions) required:** Permission to access Jira.

## Query parameters

- `startAt` integer — The index of the first item to return in a page of results (page offset).
- `maxResults` integer — The maximum number of items to return per page.
- `projectId` integer[], required — The IDs of projects to return fields for.
- `workTypeId` integer[], required — The IDs of work types (issue types) to return fields for.
- `fieldId` string[] — The IDs of fields to return. If not provided, all fields are returned.

## Response `200`

Returned if the request is successful.

- PageBean2ProjectFieldBean — 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` ProjectFieldBean[] — The list of items.
    - `description` string
    - `fieldId` string
    - `isRequired` boolean
    - `projectId` integer
    - `workTypeId` integer

## Other responses

- `400` — Returned if the request parameters are invalid.
- `401` — Returned if authentication is missing.
- `403` — Returned if the user does not have permission to view the projects or work types.
- `404` — Returned if the endpoint is not enabled via feature flag.

---

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