> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/EvolutionAPI/evolution-api/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Group Info

> Retrieve detailed information about a WhatsApp group.

## Overview

You can fetch comprehensive information about a group, including its metadata, participants, settings, and description.

## Authentication

This endpoint requires authentication via the `apikey` header.

<ParamField path="header.apikey" type="string" required>
  Your Evolution API key for authentication.
</ParamField>

## Path Parameters

<ParamField path="path.instanceName" type="string" required>
  The name of your WhatsApp instance.
</ParamField>

## Query Parameters

<ParamField query="groupJid" type="string" required>
  The WhatsApp group JID. You can provide it with or without the `@g.us` suffix (e.g., `120363123456789` or `120363123456789@g.us`).
</ParamField>

## Response

<ResponseField name="id" type="string">
  The WhatsApp JID of the group.
</ResponseField>

<ResponseField name="subject" type="string">
  The group name.
</ResponseField>

<ResponseField name="subjectOwner" type="string">
  The JID of who last changed the group subject.
</ResponseField>

<ResponseField name="subjectTime" type="number">
  Unix timestamp of when the subject was last changed.
</ResponseField>

<ResponseField name="size" type="number">
  Number of participants in the group.
</ResponseField>

<ResponseField name="creation" type="number">
  Unix timestamp of when the group was created.
</ResponseField>

<ResponseField name="owner" type="string">
  The JID of the group creator.
</ResponseField>

<ResponseField name="desc" type="string">
  The group description.
</ResponseField>

<ResponseField name="descId" type="string">
  Unique identifier for the current description.
</ResponseField>

<ResponseField name="descOwner" type="string">
  The JID of who last changed the description.
</ResponseField>

<ResponseField name="descTime" type="number">
  Unix timestamp of when the description was last changed.
</ResponseField>

<ResponseField name="participants" type="array">
  Array of group participants.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Participant's WhatsApp JID.
    </ResponseField>

    <ResponseField name="isAdmin" type="boolean">
      Whether the participant is an admin.
    </ResponseField>

    <ResponseField name="isSuperAdmin" type="boolean">
      Whether the participant is a super admin (group creator).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="announce" type="boolean">
  Whether the group is announcement-only (only admins can send messages).
</ResponseField>

<ResponseField name="restrict" type="boolean">
  Whether the group settings are restricted (only admins can change group info).
</ResponseField>

<ResponseField name="ephemeralDuration" type="number">
  Disappearing messages duration in seconds (0 means disabled).
</ResponseField>

<ResponseField name="inviteCode" type="string">
  The group's current invite code.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.example.com/group/findGroupInfos/my-instance?groupJid=120363123456789@g.us' \
    --header 'apikey: YOUR_API_KEY'
  ```

  ```javascript JavaScript theme={null}
  const groupJid = '120363123456789@g.us';

  const response = await fetch(
    `https://api.example.com/group/findGroupInfos/my-instance?groupJid=${groupJid}`,
    {
      method: 'GET',
      headers: {
        'apikey': 'YOUR_API_KEY'
      }
    }
  );

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  group_jid = '120363123456789@g.us'

  response = requests.get(
      f'https://api.example.com/group/findGroupInfos/my-instance?groupJid={group_jid}',
      headers={'apikey': 'YOUR_API_KEY'}
  )

  data = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "id": "120363123456789@g.us",
    "subject": "Project Team",
    "subjectOwner": "5511999999999@s.whatsapp.net",
    "subjectTime": 1709553600,
    "size": 5,
    "creation": 1709467200,
    "owner": "5511999999999@s.whatsapp.net",
    "desc": "Team collaboration group for the new project",
    "descId": "3EB0ABC123456789",
    "descOwner": "5511999999999@s.whatsapp.net",
    "descTime": 1709553600,
    "participants": [
      {
        "id": "5511999999999@s.whatsapp.net",
        "isAdmin": true,
        "isSuperAdmin": true
      },
      {
        "id": "5511888888888@s.whatsapp.net",
        "isAdmin": true,
        "isSuperAdmin": false
      },
      {
        "id": "5511777777777@s.whatsapp.net",
        "isAdmin": false,
        "isSuperAdmin": false
      }
    ],
    "announce": false,
    "restrict": true,
    "ephemeralDuration": 0,
    "inviteCode": "F1EX5QZxO181L3TMVP31gY"
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "error": "The group id needs to be informed in the query",
    "message": "ex: \"groupJid=120362@g.us\""
  }
  ```

  ```json 401 Unauthorized theme={null}
  {
    "error": "Unauthorized",
    "message": "Invalid API key"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Group not found",
    "message": "The specified group does not exist or you are not a member"
  }
  ```
</ResponseExample>

## Usage Notes

<Info>
  You must be a member of the group to retrieve its information.
</Info>

<Tip>
  The `@g.us` suffix is automatically added if you provide only the numeric group ID.
</Tip>