---
title: "Search field scheme fields"
method: GET
path: "/rest/api/2/config/fieldschemes/{id}/fields"
tags: ["Field schemes"]
---

# Search field scheme fields

`GET /rest/api/2/config/fieldschemes/{id}/fields`

Search for fields belonging to a given field association scheme.

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

## Path parameters

- `id` integer, required

## Query parameters

- `startAt` integer
- `maxResults` integer
- `fieldId` string[]

## Response `200`

Returns the matching fields, at the specified page of the results.

- PageBean2FieldAssociationSchemeFieldSearchResult — 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` FieldAssociationSchemeFieldSearchResult[] — The list of items.
    - `allowedOperations` string[]
    - `fieldId` string
    - `parameters` SearchResultFieldParameters
      - `description` string
      - `isRequired` boolean
      - `rendererType` string
    - `restrictedToWorkTypes` string[]
    - `workTypeParameters` SearchResultWorkTypeParameters[]
      - `description` string
      - `isRequired` boolean
      - `rendererType` string
      - `workTypeId` string

## Other responses

- `400` — Returned if the request parameters are invalid (e.g., negative startAt, maxResults exceeding limit, duplicate fieldIds).
- `401` — Returned if the authentication credentials are incorrect or missing.
- `403` — Returned if the user does not have the required permissions.
- `404` — Returned if the feature flag is disabled or the scheme ID is not found.

---

[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-service-production.skmtc.workers.dev/v1/apis/atlassian/the-jira-cloud-platform-rest-api/revisions/7e9af75061ea/schema)