---
title: "GET /v1/spaces:findGroupChats"
method: GET
path: "/v1/spaces:findGroupChats"
tags: ["spaces"]
---

# GET /v1/spaces:findGroupChats

`GET /v1/spaces:findGroupChats`

Returns all spaces with `spaceType == GROUP_CHAT`, whose human memberships contain exactly the calling user, and the users specified in `FindGroupChatsRequest.users`. Only members that have joined the conversation are supported. For an example, see [Find group chats](https://developers.google.com/workspace/chat/find-group-chats). If the calling user blocks, or is blocked by, some users, and no spaces with the entire specified set of users are found, this method returns spaces that don't include the blocked or blocking users. The specified set of users must contain only human (non-app) memberships. A request that contains non-human users doesn't return any spaces. Requires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes): - `https://www.googleapis.com/auth/chat.memberships.readonly` - `https://www.googleapis.com/auth/chat.memberships`

## Query parameters

- `pageSize` integer
- `pageToken` string
- `spaceView` 'SPACE_VIEW_UNSPECIFIED' | 'SPACE_VIEW_RESOURCE_NAME_ONLY' | 'SPACE_VIEW_EXPANDED'
- `users` string[]

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/chat.md) · [All operations](https://skmtc.net/google/apis/chat/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/chat/versions/a57a778f1fcb/schema)