--- title: Searching for groups description: Use search parameters and filters to find groups in your PingOne environment. component: pingone page_id: pingone:directory:p1_searching_groups canonical_url: https://docs.pingidentity.com/pingone/directory/p1_searching_groups.html revdate: May 20, 2025 section_ids: steps: Steps scim-query-groups: Building SCIM filter language queries to search for groups filtering-groups: Filtering groups --- # Searching for groups Use search parameters and filters to find groups in your environment. ## Steps 1. In the PingOne admin console, go to **Directory > Groups**. 2. In the **Search** field, enter the search terms. You can enter plain text or SCIM queries. If you're using plain text for your search, the list of groups updates as you enter the search query. For SCIM queries, you must press Enter to see the search results. ### Building SCIM filter language queries to search for groups System for Cross-domain Identity Management (SCIM) *(tooltip: \
\

An application-level, HTTP-based protocol for provisioning and managing user identity information. SCIM supplies a common schema for representing users and groups and provides a REST API.\

\
)* is an open standard for managing user identity information across applications or identity domains. You can use the SCIM filter language to build a query to find groups in PingOne. The following example is a simple query to find a group by group name: ``` name eq "sales" ``` You can join filter expressions by using the `and` and `or` operators and grouping them in parentheses. For example, to find all groups that have a name of `Sales` and an external ID that starts with the letter `W`, use the following query: ``` (name eq "Sales") and (externalId sw "W") ``` You can find a full list of operators and supported attributes in [Filtering groups searches](https://developer.pingidentity.com/pingone-api/platform/groups.html#groups-filtering-groups-searches) in the PingOne API documentation. ## Filtering groups | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | The filters available depend on the groups in your environment. For example, if there are no external groups, you won't see the **Source** or **Sync Type** filters. | 1. In the PingOne admin console, go to **Directory > Groups**. 2. In the **Search** field, enter the desired search terms. 3. To the right of the search box, click the **Filter** icon ([icon: filter, set=fa]). 4. Select one or more of the following filters: | Filter | Description | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Source** | The **Source** filter is available only if you have external groups in your environment. Learn more about external group sources in [Just-in-time provisioning of external groups](p1_provision_external_groups.html).Select one of the following options and then select the specific gateway or IdP from the **Name** list:- **Gateway** Shows groups for which the source is an LDAP gateway. - **External Identity Provider** Shows groups for which the source is an external IdP.![A screen capture of the Groups Filter panel with External Identity Provider selected for Type and Facebook selected for Name.](_images/mwh1702056025478.png) | | **Administrator Roles** | The **Administrator Roles** filter is available only if you have groups that are assigned administrator roles in your environment. Learn more in [Managing group roles](p1_add_roles_to_a_group.html).To filter by whether roles are assigned to the group, from **Administrator Roles** select one of the following checkboxes:- **Roles Assigned** Shows only groups that have been granted administrator roles. - **No Roles** Shows only groups that aren't granted any administrator roles. | | **Population** | To show groups that belong to specific populations, search for and select one or more populations from the list.![A screen capture of the Population filter in the Groups filter panel showing the search field and two populations.](_images/p1-groups-search-pop-filter.png) | The list of groups updates as you enter search terms and select filtering criteria. To clear all filters, click **Clear**. 5. Click a group name in the results to open the group details panel.