Get Group Members

GET /group/member

Get the member list of one group, up to 10,000 members. Each member's id works directly as user in Send Message and Send Typing.

Endpoint Details

• Base URL: https://api-zate.azickri.com
• Headers: id and session-id
• Requirement: the session must be connected (isConnected: true)

Parameters

Parameter	In	Type	Required	Description
id	header	string	Yes	id from Create Session.
session-id	header	string	Yes	sessionId from Create Session.
groupId	query	string	Yes	Group ID, like -1001234567890, or a public group's username.

Example Request

cURL

curl "https://api-zate.azickri.com/group/member?groupId=-1001234567890" \
  -H "id: YOUR_ID" \
  -H "session-id: YOUR_SESSION_ID"

Axios

import axios from 'axios';

const response = await axios.get('https://api-zate.azickri.com/group/member', {
  params: {
    groupId: '-1001234567890',
  },
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
  },
});

console.log(response.data);

Fetch

const params = new URLSearchParams({
  groupId: '-1001234567890',
});

const response = await fetch(`https://api-zate.azickri.com/group/member?${params}`, {
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
  },
});

const data = await response.json();
console.log(data);

Response

200

{
  "docs": [
    {
      "id": "123456789",
      "name": "Azickri",
      "username": "azickri",
      "phone": "6281234567890"
    },
    {
      "id": "111222333",
      "name": "Budi",
      "username": "budi",
      "phone": ""
    }
  ]
}

400

// groupId missing
{
  "statusCode": 400,
  "message": "groupId must be a string\ngroupId should not be empty"
}

// Not a group, or one you haven't joined
{
  "statusCode": 400,
  "message": "group not found"
}

404

{
  "statusCode": 404,
  "message": "session not found"
}

500

// The group hides its members and you're not an admin
{
  "statusCode": 500,
  "message": "400: CHAT_ADMIN_REQUIRED (caused by channels.GetParticipants)"
}

Field	Type	Description
docs	array	List of group members.
docs[].id	string	Telegram user ID.
docs[].name	string	Display name. Falls back to the username, phone, or ID when empty.
docs[].username	string	Username without @. Empty if they have none.
docs[].phone	string	Phone number. Empty unless the member shares it with your account.

Groups that hide their members

Supergroup admins can hide the member list. In such groups only admins can fetch it, otherwise Telegram refuses with CHAT_ADMIN_REQUIRED.