---
title: "GET /v2/me/chats"
method: GET
path: "/v2/me/chats"
tags: ["Messaging"]
---

# GET /v2/me/chats

`GET /v2/me/chats`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/me/chats`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Cursor page of the caller's chats

- ChatPage
  - `chats` Chat[], required
    - `chat_id` string, uuid, required
    - `created_at_unix_ms` integer, required
    - `created_by_user_id` string, uuid, required
    - `deleted_at_unix_ms` integer, nullable, required
    - `description` string, nullable, required
    - `dm_peer` MessagingUserSummary, required
      - `avatar_url` string, nullable, required: Approved profile image or stable CALLD default avatar URL.
      - `display_name` string, nullable, required
      - `user_id` string, uuid, required
      - `username` string, required
    - `discoverability` 'listed' | 'unlisted', required
    - `join_policy` unknown, required
    - `last_message` ChatLastMessage, required
      - `author` MessagingUserSummary, required
        - `avatar_url` string, nullable, required: Approved profile image or stable CALLD default avatar URL.
        - `display_name` string, nullable, required
        - `user_id` string, uuid, required
        - `username` string, required
      - `body` string, required: At most the first 200 Unicode code points of a nonempty message body; media-only messages use Photo, N photos, GIF or Media unavailable from current attachment state. An external-GIF-only message uses GIF. No external reference or rendition URL is included in chat-list previews.
      - `created_at_unix_ms` integer, required
      - `message_id` string, uuid, required
      - `sequence` string, required
    - `kind` 'dm' | 'group', required
    - `name` string, nullable, required
    - `read_access` 'public' | 'members', required
    - `updated_at_unix_ms` integer, required
    - `unread_count` string, required
    - `version` string, required
    - `member_count` string, required: Active members, decimal string.
    - `viewer_role` unknown, required
    - `permissions` ChatPermissions, required: Management rights the caller currently holds in this chat. Display hints only: every command re-authorizes inside its transaction. Direct messages carry no rights.
      - `can_change_roles` boolean, required: Owner only: promote a member to admin or demote an admin to member.
      - `can_invite` boolean, required: Owners and admins: create invitations, list and revoke pending ones.
      - `can_remove_members` boolean, required: Owners remove anyone but the owner; admins remove ordinary members.
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Stable machine-readable private messaging problem
- `401`: Stable machine-readable private messaging problem
- `503`: Stable machine-readable private messaging problem

---

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