Get Groups

GET /group

List the WhatsApp groups your number is in. Use the id from here with Get Group Detail, Get Group Members, or to send to a group through the group field in Send Message.

Endpoint Details

• Base URL: https://api-zawa.azickri.com
• Headers: id and session-id
• Requires: a connected session (isConnected: true)

Headers

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

Example Request

cURL

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

console.log(response.data);

Fetch

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

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

Response

200

{
  "docs": [
    {
      "id": "120363000000000000@g.us",
      "name": "Zawa Community",
      "description": "A place for Zawa users to hang out",
      "picture": "https://pps.whatsapp.net/v/t61.24694-24/...",
      "created": "2025-06-07T15:15:51.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	The list of groups.
docs[].id	string	Group ID, formatted as ...@g.us.
docs[].name	string	Group name.
docs[].description	string	Group description. Empty if there isn't one.
docs[].picture	string	URL of the group picture. Empty if the group has no picture.
docs[].created	string | null	When the group was created (ISO 8601).

In a lot of groups?

Each group's picture is fetched one by one, so if you're in hundreds of groups, the response takes longer. If you only need one group, use Get Group Detail instead.