---
title: "Get members"
method: GET
path: "/chats/{chatId}/members"
tags: ["chats"]
---

# Get members

`GET /chats/{chatId}/members`

## Request

- Base URL: `https://botapi.tamtam.chat`
- URL: `https://botapi.tamtam.chat/chats/{chatId}/members`
- Auth: API key in query parameter `access_token`

Returns users participated in chat.

## Path parameters

- `chatId` integer, required

## Query parameters

- `user_ids` integer[], nullable
- `marker` integer
- `count` integer

## Response `200`

Returns members list and pointer to the next data page

- ChatMembersList
  - `members` ChatMember[], required: Participants in chat with time of last activity. Visible only for chat admins
    - `user_id` integer, required: Users identifier
    - `name` string, required: Users visible name
    - `username` string, nullable, required: Unique public user name. Can be `null` if user is not accessible or it is not set
    - `is_bot` boolean, required: `true` if user is bot
    - `last_activity_time` integer, required: Time of last user activity in TamTam (Unix timestamp in milliseconds). Can be outdated if user disabled its "online" status in settings
    - `description` string, nullable: User description. Can be `null` if user did not fill it out
    - `avatar_url` string: URL of avatar
    - `full_avatar_url` string: URL of avatar of a bigger size
    - `last_access_time` integer, required: User last activity time in chat. Can be outdated for super chats and channels (equals to `join_time`)
    - `is_owner` boolean, required
    - `is_admin` boolean, required
    - `join_time` integer, required
    - `permissions` ChatAdminPermission[], nullable, required: Permissions in chat if member is admin. `null` otherwise
  - `marker` integer, nullable: Pointer to the next data page

## Other responses

- `401`: Authorization Error. No `access_token` provided or token is invalid
- `403`: Access error. You don't have permissions to access this resource
- `404`: Requested resource is not found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/tamtam/apis/tamtam-bot-api.md) - [All operations](https://skmtc.dev/tamtam/apis/tamtam-bot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tamtam/apis/tamtam-bot-api/revisions/fa85402ea716?raw)