# Retrieve a list of all managed users

Get list of managed users

## Endpoints

`GET` `/api/v1/mdm/users`

## Request URL

```text
https://{server-hostname}:8383/api/v1/mdm/users
```

## Scope

```text
MDMUser.READ
```

## Header

```text
Authorization: d92d4xxxxxxxxxxxxx15f52
```

## Request Parameters

### Request Headers

- **Accept** `string` — **Mandatory** — `application/json`

### Query Parameters

- **limit** `integer` — Optional

  Maximum number of records to return in a single response. Used together with offset for pagination

- **skip-token** `string` — Optional

  Pagination continuation token returned by a previous response. Pass it to fetch the next page of results

- **offset** `integer` — Optional

  Zero-based index of the first record to return. Used together with limit for pagination

- **delta-token** `string` — Optional

  Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point

- **search** `string` — Optional

  Free-text search string applied to the default searchable fields of the resource

- **user_identifier** `string` — Optional

- **include** `string` — Optional

  Comma-separated list of related fields to include in the response (e.g., assigned_to, payload_details). When omitted, only top-level fields are returned

- **select_all** `boolean` — Optional

  When true, applies the operation to every record matching the current filter rather than to specific IDs. Default: false

- **user_type** `string` — Optional

  Filter results by user type. Allowed values: 1=Domain User, 2=Local User, 3=Active Directory User, 4=Azure AD User

## Sample Request

```bash
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/users?limit=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE&offset=SOME_INTEGER_VALUE&delta-token=SOME_STRING_VALUE&search=SOME_STRING_VALUE&user_identifier=SOME_STRING_VALUE&include=SOME_STRING_VALUE&select_all=SOME_BOOLEAN_VALUE&user_type=SOME_STRING_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

#### Response Body — application/json

- `JSON Object`
  - **users** `JSON Array`

    Array of managed user objects

  - **metadata** `JSON Object`

    Metadata about the result set including total record count

  - **paging** `JSON Object`

    Pagination links for navigating result pages

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

### List of managed users with pagination

```json
{
  "metadata": {
    "total_record_count": "2"
  },
  "paging": {
    "next": "https://appDomain/api/v1/mdm/users?skip-token=NDo1OjE6MTU2ODcyMzM5NjUwOQ%3D%3D"
  },
  "users": [
    {
      "user_email": "email_address@zylker.com",
      "domain_name": "mdm",
      "user_id": "9007199254740999",
      "user_name": "admin",
      "phone_number": "+1-555-0****99",
      "device_count": 0
    },
    {
      "user_email": "john.doe@zylker.com",
      "domain_name": "mdm",
      "user_id": "9007199254741000",
      "user_name": "Zylker User",
      "phone_number": "+1-555-****12",
      "device_count": 2
    }
  ]
}
```

### No managed users found

```json
{
  "metadata": {
    "total_record_count": "0"
  },
  "paging": {},
  "users": []
}
```

![ ](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 120 | **Lock period:** 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.