Merge pull request #9016 from AmandaAZ/Branch-CI5820

AB#5820: Convert blog post to article

Author: Simonx Xu

support/entra/entra-id/toc.yml

@@ -299,6 +299,8 @@
      href: users-groups-entra-apis/delta-query-not-supported-for-aad-b2c-tenant.md
    - name: Handling errors in Graph API requests with Invoke-RestMethod
      href: app-integration/graph-api-error-handling-invoke-restmethod.md
+   - name: Only one user is returned when running List users API
+     href: users-groups-entra-apis/only-one-user-returned-by-microsoft-graph-list-users-api.md
    - name: Troubleshoot Authorization RequestDenied error
      href: app-integration/troubleshoot-authorization-requestdenied-graph-api.md
    - name: The memberOf API returns null values for properties

support/entra/entra-id/users-groups-entra-apis/media/only-one-user-returned-by-microsoft-graph-list-users-api/list-users-query-result.png

@@ -0,0 +1,35 @@
+---
+title: Microsoft Graph List Users API Only Return One User
+description: Provides a solution to an issue where the Microsoft Graph REST API List users only returns one user in a directory.
+ms.date: 06/09/2025
+ms.service: entra-id
+ms.reviewer: bachoang, v-weizhu
+ms.custom: sap:Problem with querying or provisioning resources
+---
+# Microsoft Graph List users API only returns one user in a directory
+
+This article provides a solution to an issue where the Microsoft Graph REST API [List users](/graph/api/user-list) only returns one user in a directory.
+
+## Symptoms
+
+Consider the following scenario:
+
+- You sign in to [Microsoft Graph Explorer](https://developer.microsoft.com/en-us/graph/graph-explorer) by selecting the profile icon at the top right.
+
+    :::image type="content" source="media/only-one-user-returned-by-microsoft-graph-list-users-api/microsoft-graph-explorer-sign-in.png" alt-text="Screenshot that shows the sign-in button in Microsoft Graph Explorer." lightbox="media/only-one-user-returned-by-microsoft-graph-list-users-api/microsoft-graph-explorer-sign-in.png":::
+
+- After sign-in, you try to run this query `GET https://graph.microsoft.com/v1.0/users` to retrieve all users in your directory.
+
+In this case, only one user is returned. The expected output is a list of multiple users from the directory.
+
+:::image type="content" source="media/only-one-user-returned-by-microsoft-graph-list-users-api/list-users-query-result.png" alt-text="Screenshot that shows the query result." lightbox="media/only-one-user-returned-by-microsoft-graph-list-users-api/list-users-query-result.png":::
+
+## Cause
+
+This issue occurs because you sign in with a personal Microsoft account (MSA), as shown in the preceding screenshot. Personal accounts don't have access to organizational directory data in Microsoft Entra ID. As a result, the query only returns the user associated with the personal account.
+
+## Solution
+
+To retrieve all users in the directory, you must sign in to Microsoft Graph Explorer using an organizational Microsoft Entra account, such as `userPrincipalName = [email protected]`.
+
+[!INCLUDE [Azure Help Support](../../../includes/azure-help-support.md)]