Find users using filters
POST/user-srv/graph/users
Find users using graph filters to select users and limit retrieved fields. This flexible approach allows precise user filtering. Be aware that this is recommended only for reports and comparisons.
Generic graph filter (since 3.102.4+): Use filters, matchCondition, and dateField for field-based filtering with operators such as CONTAINS, BOOL_CHECK, EXISTS, and STRING_SEARCH_OPTIONS. Legacy fields (fieldsFilter, rangefield, from_value, to_value, time_zone) are still accepted, auto-normalized to the generic format, but deprecated.
User-specific filters: groupsFilter, groupsCondition, terms (free-text search across multiple fields), and fields (space-separated projection of returned attributes).
Pagination and sorting: from (offset), size (page size; max 1000), sortfield, and descending. By default the response includes the total match count; set excludeUserCount: true to omit it.
See User Search for operator semantics and field reference. For count-only queries (metrics, dashboards), use Find user counts using filters.
Note: This API supports fetching 0 to 10k records. For more than 10k users, use Read users in bulk mode, which is recommended for exports and reports.
Request
Responses
- 200
- 204
- 401
- 417
The response contains an array of users.
No Content
Unauthorized
Expectation Failed