---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/users"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/users"
tags: ["Users"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/users

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/users`

Gets all the users registered on a Data Box Edge/Data Box Gateway device.

## Path parameters

- `deviceName` string, required
- `subscriptionId` string, required
- `resourceGroupName` string, required

## Query parameters

- `api-version` string, required
- `$filter` string

## Response `200`

The collection of all users on the device.

- UserList — Collection of users.
  - `value` User[] — The list of users.
    - `id` string — The path ID that uniquely identifies the object.
    - `name` string — The object name.
    - `type` string — The hierarchical type of the object.
  - `nextLink` string — Link to the next set of results.

## Other responses

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

## Changes

- **2026-07-13** (2019-03-01) `0ab925cce842` — 3 warning
  - deleted the `path` request parameter `resourceGroupName`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2019-03-01) `153dabd37502` — 1 warning, 1 info
  - deleted the `query` request parameter `$filter`
  - added the new optional `query` request parameter `$expand`
- **2026-07-13** (2019-03-01) `ddd0279925a8` — 1 warning, 1 info
  - deleted the `query` request parameter `$expand`
  - added the new optional `query` request parameter `$filter`
- **2026-07-13** (2019-03-01) `f232af363694` — 1 warning, 1 info
  - deleted the `query` request parameter `$expand`
  - added the new optional `query` request parameter `$filter`
- **2026-07-13** (2019-03-01) `50d853c4e655` — 1 info
  - added the new optional `query` request parameter `$filter`

[Full history](https://skmtc.dev/azure/apis/databoxedge-microsoft-databoxedge-databoxedge/changes/subscriptions/:subscriptionId/resourceGroups/:resourceGroupName/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/:deviceName/users/get.md)

---

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