---
title: "Get custom field contexts"
method: GET
path: "/rest/api/3/field/{fieldId}/context"
tags: ["Issue custom field contexts"]
---

# Get custom field contexts

`GET /rest/api/3/field/{fieldId}/context`

Returns a [paginated](#pagination) list of [ contexts](https://confluence.atlassian.com/adminjiracloud/what-are-custom-field-contexts-991923859.html) for a custom field. Contexts can be returned as follows:

 *  With no other parameters set, all contexts.
 *  By defining `id` only, all contexts from the list of IDs.
 *  By defining `isAnyIssueType`, limit the list of contexts returned to either those that apply to all issue types (true) or those that apply to only a subset of issue types (false)
 *  By defining `isGlobalContext`, limit the list of contexts return to either those that apply to all projects (global contexts) (true) or those that apply to only a subset of projects (false).

**[Permissions](#permissions) required:** *Administer Jira* [global permission](https://confluence.atlassian.com/x/x4dKLg). *Edit Workflow* [edit workflow permission](https://support.atlassian.com/jira-cloud-administration/docs/permissions-for-company-managed-projects/#Edit-Workflows)

## Path parameters

- `fieldId` string, required

## Query parameters

- `isAnyIssueType` boolean
- `isGlobalContext` boolean
- `contextId` integer[]
- `startAt` integer
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- PageBeanCustomFieldContext — 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` CustomFieldContext[] — The list of items.
    - `description` string, required — The description of the context.
    - `id` string, required — The ID of the context.
    - `isAnyIssueType` boolean, required — Whether the context apply to all issue types.
    - `isGlobalContext` boolean, required — Whether the context is global.
    - `name` string, required — The name of the context.

## Other responses

- `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 custom field was not found.

---

[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/ec7f275dfee5/schema)