Member

Group Member API for ManageEngine ID360

Download Member OpenAPI Document

End Points

GET

/groups/{id}/members

Attribute

string

The unique identifier for the user, assigned by the system.

display_name

string

The display name of the user.

string

The email address of the user.

primary_source

object

Details about the primary directory of the group.

Show Sub-Attributes

string

The unique identifier for the directory.

name

string

The name of the application or directory.

application_service

object

Details about the service associated with the directory or app.

Show Sub-Attributes

string

The unique identifier for the application service.

display_name

string

Application Service Name

name

string

Service Name

logo

string

Application Service Logo

{
    "id": "2000000108825",
    "display_name": "John Doe",
    "email": "johndoe@email.com",
    "primary_source": {
        "id": "2000000072637",
        "name": "Berge-Corp",
        "application_service": {
            "id": "2000000018007",
            "display_name": "Universal Directory",
            "name": "ZOHO_DIRECTORY",
            "logo": "universal-directory"
        }
    }
}

Get Group Members

The Get Group Members API can be used to fetch the members of a specific group in your account.
OAuth Scope : id360.group.READ,id360.group.ALL

Query Parameters

fields

Select the fields to be fetched in the response.

Request Example

headers_data = Map();
headers_data.put("Accept", "application/json");
headers_data.put("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f");
response = invokeUrl
[
url: "https://id360.manageengine.com/api/v1/groups/987000000654321/members"
type: GET
headers: headers_data
connection: <connection_name>
];
info response;

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://id360.manageengine.com/api/v1/groups/987000000654321/members")
  .get()
  .addHeader("Accept", "application/json")
  .addHeader("Authorization", "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f")
  .build();

Response response = client.newCall(request).execute();

const options = {
  method: 'GET',
  headers: {
    Accept: 'application/json',
    Authorization: 'Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'
  }
};

fetch('https://id360.manageengine.com/api/v1/groups/987000000654321/members', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

import http.client

conn = http.client.HTTPSConnection("id360.manageengine.com")

headers = {
    'Accept': "application/json",
    'Authorization': "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
    }

conn.request("GET", "/api/v1/groups/987000000654321/members", headers=headers)

res = conn.getresponse()
data = res.read()

print(data.decode("utf-8"))

const http = require("https");

const options = {
  "method": "GET",
  "hostname": "id360.manageengine.com",
  "port": null,
  "path": "/api/v1/groups/987000000654321/members",
  "headers": {
    "Accept": "application/json",
    "Authorization": "Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f"
  }
};

const req = http.request(options, function (res) {
  const chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    const body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();

curl --request GET \
  --url https://id360.manageengine.com/api/v1/groups/987000000654321/members \
  --header 'Accept: application/json' \
  --header 'Authorization: Zoho-oauthtoken 1000.41d9xxxxxxxxxxxxxxxxxxxxxxxxc2d1.8fccxxxxxxxxxxxxxxxxxxxxxxxx125f'

Response Example

{
    "data": [
        {
            "id": "2000000108825",
            "display_name": "John Doe",
            "email": "johndoe@email.com",
            "primary_source": {
                "id": "2000000072637",
                "name": "Berge-Corp",
                "application_service": {
                    "id": "2000000018007",
                    "display_name": "Universal Directory",
                    "name": "ZOHO_DIRECTORY",
                    "logo": "universal-directory"
                }
            }
        },
        {
            "id": "2000000108623",
            "display_name": "Jane Smith",
            "email": "janesmith@email.com",
            "primary_source": {
                "id": "2000000072637",
                "name": "Berge-Corp",
                "application_service": {
                    "id": "2000000018007",
                    "display_name": "Universal Directory",
                    "name": "ZOHO_DIRECTORY",
                    "logo": "universal-directory"
                }
            }
        }
    ],
    "meta": {
        "cursor": null,
        "next_cursor": null,
        "is_last": true,
        "limit": 100,
        "total_no_of_objects": 2
    }
}

{
    "error": {
        "code": "00000107",
        "title": "Invalid Parameter",
        "detail": "The parameter select is invalid."
    }
}

{
    "error": {
        "code": "00000101",
        "title": "Unauthorized",
        "detail": "The OAuth token is invalid."
    }
}

{
    "error": {
        "code": "*****",
        "title": "Resource Not Found",
        "detail": "This Group does not exist."
    }
}

{
    "error": {
        "code": "00000000",
        "title": "Internal Server Error",
        "detail": "An unexpected internal error has occurred on the server. Please try again later."
    }
}