v4

latestOpenAPI 3.0.1Apache 2.02026-08-016079122.3 MB
Issue fields

Get fields paginated

Returns a paginated list of fields for Classic Jira projects. The list can include:

  • all fields
  • specific fields, by defining id
  • fields that contain a string in the field name or description, by defining query
  • specific fields that contain a string in the field name or description, by defining id and query

Use type must be set to custom to show custom fields only.

Permissions required: Permission to access Jira.

get/rest/api/2/field/search

Query parameters

startAtinteger

The index of the first item to return in a page of results (page offset).

maxResultsinteger

The maximum number of items to return per page.

typestring[]

The type of fields to search.

idstring[]

The IDs of the custom fields to return or, where query is specified, filter.

querystring

String used to perform a case-insensitive partial match with field names or descriptions.

orderBy'contextsCount' | '-contextsCount' | '+contextsCount' | 'lastUsed' | '-lastUsed' | '+lastUsed' | 'name' | '-name' | '+name' | 'screensCount' | '-screensCount' | '+screensCount' | 'projectsCount' | '-projectsCount' | '+projectsCount'

Order the results by:

  • contextsCount sorts by the number of contexts related to a field
  • lastUsed sorts by the date when the value of the field last changed
  • name sorts by the field name
  • screensCount sorts by the number of screens related to a field
expandstring

Use expand to include additional information in the response. This parameter accepts a comma-separated list. Expand options include:

  • key returns the key for each field
  • stableId returns the stableId for each field
  • lastUsed returns the date when the value of the field last changed
  • screensCount returns the number of screens related to a field
  • contextsCount returns the number of contexts related to a field
  • isLocked returns information about whether the field is locked
  • searcherKey returns the searcher key for each custom field
projectIdsinteger[]

The IDs of the projects to filter the fields by. Fields belonging to project Ids that the user does not have access to will not be returned

Response

Returned if the request is successful.

isLastboolean

Whether this is the last page.

maxResultsinteger

The maximum number of items that could be returned.

nextPagestring uri

If there is another page of results, the URL of the next page.

selfstring uri

The URL of the page.

startAtinteger

The index of the first item returned.

totalinteger

The number of items returned.