---
title: "GET /{tenantID}/users"
method: GET
path: "/{tenantID}/users"
tags: ["User"]
---

# GET /{tenantID}/users

`GET /{tenantID}/users`

Gets list of users for the current tenant.

## Path parameters

- `tenantID` string, required

## Query parameters

- `$filter` string
- `$expand` string
- `$top` integer
- `api-version` string, required

## Response `200`

OK. The operation was successful.

- UserListResult — Server response for Get tenant users API call.
  - `value` User[] — the list of users.
    - `objectId` string — The object ID.
    - `objectType` string, required — The object type.
    - `deletionTimestamp` string, date-time, nullable — The time at which the directory object was deleted.
  - `odata.nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — Error response describing why the operation failed.

## Changes

- **2026-07-13** (1.6) `71d95005600e` — 1 info
  - added the new optional `query` request parameter `$top`
- **2020-04-22** (1.6) `18c48f2106b6` — 1 info
  - added the new optional `query` request parameter `$expand`
- **2018-12-05** (1.6) `7ad94c1e7767` — 2 warning
  - deleted the `query` request parameter `$expand`
  - deleted the `query` request parameter `$top`

[Change history](https://skmtc.dev/azure/apis/graphrbacmanagementclient/changes/:tenantID/users/get.md)

---

[API](https://skmtc.dev/azure/apis/graphrbacmanagementclient.md) · [All operations](https://skmtc.dev/azure/apis/graphrbacmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/graphrbacmanagementclient/revisions/71d95005600e/schema)