---
title: "Get custom field options (context)"
method: GET
path: "/rest/api/3/field/{fieldId}/context/{contextId}/option"
tags: ["Issue custom field options"]
---

# Get custom field options (context)

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

## Request

- Base URL: `https://your-domain.atlassian.net`
- URL: `https://your-domain.atlassian.net/rest/api/3/field/{fieldId}/context/{contextId}/option`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://auth.atlassian.com/authorize`
    - Token URL: `https://auth.atlassian.com/oauth/token` scopes: `manage:jira-configuration`

Returns a [paginated](#pagination) list of all custom field option for a context. Options are returned first then cascading options, in the order they display in Jira.

This operation works for custom field options created in Jira or the operations from this resource. **To work with issue field select list options created for Connect apps use the [Issue custom field options (apps)](#api-group-issue-custom-field-options--apps-) operations.**

**[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
- `contextId` integer, required

## Query parameters

- `optionId` integer
- `onlyOptions` boolean
- `startAt` integer
- `maxResults` integer

## Response `200`

Returned if the request is successful.

- PageBeanCustomFieldContextOption: 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` CustomFieldContextOption[]: The list of items.
    - `disabled` boolean, required: Whether the option is disabled.
    - `id` string, required: The ID of the custom field option.
    - `optionId` string: For cascading options, the ID of the custom field option containing the cascading option.
    - `value` string, required: The value of the custom field option.

## Other responses

- `400`: Returned if the request is not valid.
- `401`: Returned if the authentication credentials are incorrect or missing.
- `403`: Returned if the user does not have the necessary permission.
- `404`: Returned if the custom field is not found or the context doesn't match the custom field.

---

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