# Retrieve a list of members present in a particular group

Get the member list of the group

## Endpoints

GET `/api/v1/mdm/groups/{group_id}/members`

## Request URL

`https://[{serverurl}](https://www.manageengine.com/mobile-device-management/help/api/cloud/oauth-authentication-endpoint-domain.html)/api/v1/mdm/groups/{group_id}/members`

## Scope

`MDMOnDemand.MDMDeviceMgmt.READ`

## Header

`Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52`

## Request Parameters

### Request Headers

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

### Path Parameters

- **group_id** — `string` — Mandatory  
  Unique identifier of the group. Obtain from the [Get Group List](https://www.manageengine.com/mobile-device-management/help/api/cloud/groups-get-group-list.html) response

### 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

- **offset** — `integer` — Optional  
  Zero-based index of the first record to return. Used together with limit for pagination

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

- **include** — `string` — Optional  
  Include member details in the response. Allowed value: `memberdetails`. When omitted, only top-level fields are returned

- **platform_type** — `string` — Optional  
  Filter results by device platform type. Allowed values: `1=iOS`, `2=Android`, `3=Windows`, `4=macOS`, `5=Chrome`, `6=tvOS`

- **os_version** — `string` — Optional  
  Filter results by exact OS version (e.g., `14.0`, `12.4.1`)

- **device_type** — `string` — Optional  
  Filter results by device type. Allowed values: `1=Mobile`, `2=Tablet`, `3=Laptop`, `4=Desktop`, `5=TV`

- **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`

- **group_category** — `string` — Optional  
  Filter groups by category. Allowed values: `1=Static`, `2=Dynamic`. Supports comma-separated values

- **search** — `string` — Optional  
  Free-text search string applied to the default searchable fields of the resource

- **select_all** — `boolean` — Optional  
  When true, applies the operation to every record matching the current filter rather than to specific IDs. Default: `false`

## Sample Request

```curl
curl --request GET \
  --url https://appdomain/api/v1/mdm/groups/{group_id}/members \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- `JSON object`
  - **member_ids** — `array`  
    Array of member IDs — may be Device IDs or User IDs depending on group type

## Possible Response Codes

- **200** — HTTP code

## Sample Response: HTTP 200

### List of member IDs present in the group

```json
{
  "member_ids": [
    9007199254741040,
    9007199254741040,
    9007199254741042
  ]
}
```

### Group has no members

```json
{
  "member_ids": []
}
```

## Rate Limits

![](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.