---
title: "Get users / chat members (v2)"
method: GET
path: "/v2/chats/users"
tags: ["Chats"]
---

# Get users / chat members (v2)

`GET /v2/chats/users`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/chats/users`
- Auth: HTTP bearer

**Auth**: User JWT

Returns users in the current app, or chat members when `chatName` is provided.
If `xmppUsername` or `userId` is provided, returns a single user record.
Parameters should be sent in the query string for GET requests.
Pagination uses `limit` and `offset`, where `offset` is the number of records to skip.
`xmppUsername` is the preferred identifier for single-user lookup.
`userId` is a backward-compatible identifier matched against Ethora user `uuid` and Mongo `_id`.

## Query parameters

- `chatName` string
- `xmppUsername` string
- `userId` string
- `limit` integer
- `offset` integer

## Response `200`

```
// list response:
{ limit, offset, total, items, results, pagination, success }

// single response (when xmppUsername/userId provided):
{ result, success }
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)