---
title: "GET /connections/{phoneNumber}/group-metadata"
method: GET
path: "/connections/{phoneNumber}/group-metadata"
tags: ["Connections"]
---

# GET /connections/{phoneNumber}/group-metadata

`GET /connections/{phoneNumber}/group-metadata`

## Path parameters

- `phoneNumber` string, required

## Query parameters

- `jid` string, required

## Response `200`

Group metadata retrieved successfully

- object
  - `id` string — Group JID
  - `addressingMode` string — Addressing mode of the group
  - `subject` string — Group name/subject
  - `subjectOwner` string — JID of the user who set the subject
  - `subjectOwnerPn` string — Phone number JID of the subject owner
  - `subjectTime` number — Timestamp when subject was set
  - `size` number — Number of participants in the group
  - `creation` number — Timestamp when the group was created
  - `owner` string — JID of the group owner
  - `ownerPn` string — Phone number JID of the group owner
  - `owner_country_code` string — Country code of the group owner
  - `desc` string, nullable — Group description
  - `descId` string, nullable — Description ID
  - `descOwner` string, nullable — JID of the user who set the description
  - `descTime` number, nullable — Timestamp when description was set
  - `restrict` boolean — Whether only admins can change group settings
  - `announce` boolean — Whether only admins can send messages
  - `isCommunity` boolean — Whether the group is a community
  - `isCommunityAnnounce` boolean — Whether the group is a community announcement group
  - `joinApprovalMode` boolean — Whether join requests require admin approval
  - `memberAddMode` boolean — Whether members can add other members
  - `participants` object[] — List of group participants
    - `id` string — Participant JID
    - `phoneNumber` string — Participant phone number JID
    - `admin` string, nullable — Admin status: 'superadmin', 'admin', or null
  - `ephemeralDuration` number, nullable — Duration in seconds for disappearing messages

## Other responses

- `403` — Forbidden — the API key does not own this connection. Returned when a connection is bound to a different API key.
- `421` — Misdirected Request — in cluster mode, this instance does not own the connection. The owning instance id is in the x-baileys-owner header; a proxy re-routes the request there. Not returned for POST /connections/{phoneNumber} (explicit takeover).

---

[API](https://skmtc.net/fazer-ai/apis/fazer-ai-baileys-api.md) · [All operations](https://skmtc.net/fazer-ai/apis/fazer-ai-baileys-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fazer-ai/fazer-ai-baileys-api/revisions/533b3360e2e4/schema)