# Retrieve a list of members present in a particular group

Get the member list of the group

## Endpoint

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

## Request URL

`https://{server-hostname}:8383/api/v1/mdm/groups/{group_id}/members`

## Scope

`MDMDeviceMgmt.READ`

## Header

`Authorization: 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/products/desktop-central/help/api/onpremise/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?limit=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE&offset=SOME_INTEGER_VALUE&delta-token=SOME_STRING_VALUE&include=SOME_STRING_VALUE&platform_type=SOME_STRING_VALUE&os_version=SOME_STRING_VALUE&device_type=SOME_STRING_VALUE&user_type=SOME_STRING_VALUE&group_category=SOME_STRING_VALUE&search=SOME_STRING_VALUE&select_all=SOME_BOOLEAN_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response Parameters

### HTTP Code 200

Response Body — `application/json`

- **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": []
}
```

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