Get Fields Paginated
GET {{baseUrl}}/rest/api/3/field/search?startAt=0&maxResults=50&type=<string>&type=<string>&id=<string>&query=<string>&orderBy=<string>&expand=<string>
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
andquery
.
Only custom fields can be queried, type
must be set to custom
.
Permissions required: Administer Jira global permission.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
startAt | number | The index of the first item to return in a page of results (page offset). | |
maxResults | number | The maximum number of items to return per page. | |
type | string | The type of fields to search. | |
type | string | The type of fields to search. | |
id | string | The IDs of the custom fields to return or, where query is specified, filter. | |
query | string | String used to perform a case-insensitive partial match with field names or descriptions. | |
orderBy | string | Order the results by a field: |
-
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. | |expand
| string | | 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. -
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. |
RESPONSES
status: OK
{"maxResults":50,"startAt":0,"total":2,"isLast":false,"values":[{"id":"customfield_10000","name":"Approvers","description":"Contains users needed for approval. This custom field was created by Jira Service Desk.","key":"customfield_10000","isLocked":true,"screensCount":2,"contextsCount":2,"lastUsed":{"type":"TRACKED","value":"2019-09-12T10:10:00.055+0000"}},{"id":"customfield_10001","name":"Change reason","description":"Choose the reason for the change request","key":"customfield_10001","isLocked":false,"screensCount":2,"contextsCount":2}]}