---
title: "List chats for target user (v2, tenant actor)"
method: GET
path: "/v2/apps/{appId}/users/{userId}/chats"
tags: ["Chats"]
---

# List chats for target user (v2, tenant actor)

`GET /v2/apps/{appId}/users/{userId}/chats`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v2/apps/{appId}/users/{userId}/chats`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

**Auth**: Tenant Actor

Returns chat rooms that the specified user belongs to within the target app.
Supports `User JWT` and `B2B Server JWT` for tenant actors with access to the target app.

## Path parameters

- `appId` string, required
- `userId` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `includeMembers` boolean

## Response `200`

```
{
  results: array,
  pagination: { limit: number, offset: number, total: number },
  limit: number,
  offset: number,
  total: number,
  items: array
}
```

- ChatUserChatsResponse
  - `results` ChatRecord[], required
    - `_id` string, nullable
    - `name` string
    - `title` string, nullable
    - `description` string, nullable
    - `type` string, nullable
    - `picture` string, nullable
    - `appId` string, nullable
    - `createdBy` string, nullable
    - `e2ee` boolean, nullable
    - `reported` boolean, nullable
    - `members` UserPublic[], nullable
      - `_id` string
      - `uuid` string, nullable
      - `xmppUsername` string
      - `email` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `username` string, nullable
      - `profileImage` string, nullable
      - `profilePicture` string, nullable
      - `description` string, nullable
      - `tags` string[], nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
  - `items` ChatRecord[], required
    - `_id` string, nullable
    - `name` string
    - `title` string, nullable
    - `description` string, nullable
    - `type` string, nullable
    - `picture` string, nullable
    - `appId` string, nullable
    - `createdBy` string, nullable
    - `e2ee` boolean, nullable
    - `reported` boolean, nullable
    - `members` UserPublic[], nullable
      - `_id` string
      - `uuid` string, nullable
      - `xmppUsername` string
      - `email` string, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `username` string, nullable
      - `profileImage` string, nullable
      - `profilePicture` string, nullable
      - `description` string, nullable
      - `tags` string[], nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
  - `pagination` object, required
    - `limit` integer
    - `offset` integer
    - `total` integer
  - `limit` integer, required
  - `offset` integer, required
  - `total` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: ``` { error: 'Forbidden', code: 'FORBIDDEN' } ```
- `404`: ``` { error: string, code: 'APP_NOT_FOUND'|'USER_NOT_FOUND' } ```
- `422`: ``` { error: string, code: 'VALIDATION_ERROR' } ```
- `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)