Find Users By Query
GET {{baseUrl}}/rest/api/3/user/search/query?query=<string>&startAt=0&maxResults=100
Finds users with a structured query and returns a paginated list of user details.
This operation takes the users in the range defined by startAt and maxResults, up to the thousandth user, and then returns only the users from that range that match the structured query. This means the operation usually returns fewer users than specified in maxResults. To get all the users who match the structured query, use Get all users and filter the records in your code.
Permissions required: Browse users and groups global permission.
The query statements are:
-
is assignee of PROJReturns the users that are assignees of at least one issue in project PROJ. -
is assignee of (PROJ-1, PROJ-2)Returns users that are assignees on the issues PROJ-1 or PROJ-2. -
is reporter of (PROJ-1, PROJ-2)Returns users that are reporters on the issues PROJ-1 or PROJ-2. -
is watcher of (PROJ-1, PROJ-2)Returns users that are watchers on the issues PROJ-1 or PROJ-2. -
is voter of (PROJ-1, PROJ-2)Returns users that are voters on the issues PROJ-1 or PROJ-2. -
is commenter of (PROJ-1, PROJ-2)Returns users that have posted a comment on the issues PROJ-1 or PROJ-2. -
is transitioner of (PROJ-1, PROJ-2)Returns users that have performed a transition on issues PROJ-1 or PROJ-2. -
[propertyKey].entity.property.path is "property value"Returns users with the entity property value.
The list of issues can be extended as needed, as in (PROJ-1, PROJ-2, ... PROJ-n). Statements can be combined using the AND and OR operators to form more complex queries. For example:
is assignee of PROJ AND [propertyKey].entity.property.path is "property value"
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
query | string | (Required) The search query. | |
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. |
RESPONSES
status: OK
{"self":"http://FRMCNcZdLHdZQoGioEKdL.tylpqWTBBP.SfEGEtEdYrTQryjs6E7LjXBNqMGe5z8Wqt1lybXIkYKK1oujEN-.pW","nextPage":"https://evUNQfmwcrh.tdoVs,oV+Bx2iiEWJOLfnedqgLk9IajzIktVfatPYzgkAiZVeDYJ3.","maxResults":28307979,"startAt":92589336,"total":28947857,"isLast":false,"values":[{"self":"https://WBSFeJHGtSz.pkxOixh4,wf+BWlh3q7BuwOJ5+lfxiMMwvK5deSuWojfeX+rx0","key":"\u003cstring\u003e","accountId":"\u003cstring\u003e","accountType":"unknown","name":"\u003cstring\u003e","emailAddress":"Excepteur in","avatarUrls":{"16x16":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"24x24":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"32x32":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"48x48":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"displayName":"consequat culpa ad sit","active":true,"timeZone":"non eu ad","locale":"esse nostrud ut do voluptate","groups":{"size":-13341815,"items":[{"name":"\u003cstring\u003e"},{"name":"\u003cstring\u003e"}],"pagingCallback":{},"callback":{},"max-results":-7549249},"applicationRoles":{"size":-26476401,"items":[{"key":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"groups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defaultGroups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"selectedByDefault":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defined":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"numberOfSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCountDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"hasUnlimitedSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"platform":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"key":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"groups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defaultGroups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"selectedByDefault":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defined":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"numberOfSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCountDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"hasUnlimitedSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"platform":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"pagingCallback":{},"callback":{},"max-results":-71097026},"expand":"veniam ex"},{"self":"https://tBvgzFo.vnvujFs3-iBRFRTW3uAoWxxCDoyviSlyD8NEkVUWfetpnIJFQiStC","key":"\u003cstring\u003e","accountId":"\u003cstring\u003e","accountType":"app","name":"\u003cstring\u003e","emailAddress":"amet tempor ullamco","avatarUrls":{"16x16":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"24x24":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"32x32":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"48x48":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},"displayName":"conse","active":false,"timeZone":"nisi","locale":"aliquip Ut","groups":{"size":-88980590,"items":[{"name":"\u003cstring\u003e"},{"name":"\u003cstring\u003e"}],"pagingCallback":{},"callback":{},"max-results":-49870963},"applicationRoles":{"size":-73701622,"items":[{"key":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"groups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defaultGroups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"selectedByDefault":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defined":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"numberOfSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCountDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"hasUnlimitedSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"platform":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}},{"key":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"groups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"name":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defaultGroups":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"selectedByDefault":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"defined":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"numberOfSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"remainingSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCount":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"userCountDescription":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"hasUnlimitedSeats":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"platform":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}}],"pagingCallback":{},"callback":{},"max-results":-52403192},"expand":"fugiat eiusmod ea mollit ali"}]}