Get Groups

GET /group

Get the list of Telegram groups you're in, both basic groups and supergroups. The id from here works with Get Group Detail, Get Group Members, or the group field in Send Message.

Endpoint Details

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

Headers

Header	Type	Required	Description
id	string	Yes	id from Create Session.
session-id	string	Yes	sessionId from Create Session.

Example Request

cURL

curl "https://api-zate.azickri.com/group" \
  -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', {
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
  },
});

console.log(response.data);

Fetch

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

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

Response

200

{
  "docs": [
    {
      "id": "-1001234567890",
      "name": "Zate Community",
      "username": "komunitaszate",
      "description": "A place for Zate users to hang out",
      "picture": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
      "created": "2025-06-07T15:15:51.000Z"
    },
    {
      "id": "-987654321",
      "name": "The Whole Family",
      "username": "",
      "description": "",
      "picture": "",
      "created": "2024-12-25T08:00:00.000Z"
    }
  ]
}

400

{
  "statusCode": 400,
  "message": "invalid header"
}

404

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

500

{
  "statusCode": 500,
  "message": "session not connected"
}

Field	Type	Description
docs	array	List of groups.
docs[].id	string	Group ID: -123... for basic groups, -100... for supergroups.
docs[].name	string	Group name.
docs[].username	string	Public group username without @. Empty for private and basic groups.
docs[].description	string	Group description. Cached for 5 minutes.
docs[].picture	string	Small group photo as a data URI. May be empty.
docs[].created	string	The date your account joined the group (ISO 8601).

A bit slow with many groups

Each group's description and photo are fetched from Telegram one by one. If you're in dozens of groups, the first response can take a few seconds. Later calls are faster because descriptions and photos are cached.