---
title: "Gets the list of currently joined users and their profile data."
method: GET
path: "/_matrix/client/v3/rooms/{roomId}/joined_members"
tags: ["Room participation"]
---

# Gets the list of currently joined users and their profile data.

`GET /_matrix/client/v3/rooms/{roomId}/joined_members`

## Request

- Base URL: `https://matrix.org`
- URL: `https://matrix.org/_matrix/client/v3/rooms/{roomId}/joined_members`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/matrix/apis/matrix-client-server-api/docs/_matrix/client/v3/rooms/:roomId/joined_members/get.ts> (a function with typed inputs; its response is checked against the schema)

This API returns a map of MXIDs to member info objects for members of the room. The current user must be in the room for it to work, unless it is an Application Service in which case any of the AS's users must be in the room. This API is primarily for Application Services and should be faster to respond than `/members` as it can be implemented more efficiently on the server.

## Path parameters

- `roomId` string, mx-room-id, required

## Response `200`

A map of MXID to room member objects.

- object
  - `joined` object: A map from user ID to a RoomMember object.

## Other responses

- `403`: You aren't a member of the room.

---

[API](https://skmtc.dev/matrix/apis/matrix-client-server-api.md) - [All operations](https://skmtc.dev/matrix/apis/matrix-client-server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/matrix/apis/matrix-client-server-api/revisions/c7fe4072c681?raw)