---
title: "Find Group By Remote JID"
method: GET
path: "/group/findGroupInfos/{instance}"
tags: ["Group Controller"]
---

# Find Group By Remote JID

`GET /group/findGroupInfos/{instance}`

Find group by remote JID

## Path parameters

- `instance` string, required

## Query parameters

- `groupJid` string, required

## Response `200`

Ok

- object
  - `id` string — The ID of the group.
  - `subject` string — The subject (name) of the group.
  - `subjectOwner` string — The ID of the user who set the subject.
  - `subjectTime` integer — The timestamp when the subject was set.
  - `pictureUrl` string — URL of the group's profile picture.
  - `size` integer — The number of participants in the group.
  - `creation` integer — The timestamp when the group was created.
  - `owner` string — The ID of the group owner.
  - `desc` string — The description of the group.
  - `descId` string — The ID of the description message.
  - `restrict` boolean — Indicates if the group is restricted (only admins can send messages).
  - `announce` boolean — Indicates if the group is an announcement group (only admins can send messages).
  - `participants` object[] — List of participants in the group.
    - `id` string — The ID of the participant.
    - `admin` string — The role of the participant (e.g., 'admin', 'superadmin').

## Changes

- **2024-10-14** (v2) `c153448703e5` — 1 breaking, 4 info
  - the `query` request parameter `groupJid` became required
  - api operation id `findGroupByJid` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Group Controller` added
  - …1 more
- **2024-09-09** (v2) `0c4620ca5ed5` — 5 info
  - api operation id `findGroupByJid` removed and replaced with ``
  - the endpoint scheme security `ApiKeyAuth` was removed from the API
  - api tag `Group` added
  - api tag `Group Controller` removed
  - …1 more

[Change history](https://skmtc.dev/evolution-foundation/apis/openapi/changes/group/findGroupInfos/:instance/get.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/openapi.md) · [All operations](https://skmtc.dev/evolution-foundation/apis/openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/evolution-foundation/openapi/revisions/153363ee7f38/schema)
