---
title: "listConversations"
method: GET
path: "/api/social/conversations"
tags: ["Social"]
---

# listConversations

`GET /api/social/conversations`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/social/conversations`
- Auth: HTTP bearer

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Successful HTTP response; legacy business endpoints may return success=false in this envelope, while social endpoints use matching 4xx/5xx statuses

- CommonPojoResultDataJsonResultCoreSocialPojoDtoPageDTOCoreSocialPojoDtoConversationDTO
  - `code` integer
  - `data` CoreSocialPojoDtoPageDTOCoreSocialPojoDtoConversationDTO
    - `hasMore` boolean
    - `items` CoreSocialPojoDtoConversationDTO[]
      - `canSend` boolean
      - `id` string
      - `imageMessagingEnabled` boolean
      - `lastMessage` CoreSocialPojoDtoChatMessageDTO
        - `clientMessageId` string
        - `content` string
        - `conversationId` string
        - `createdAt` string
        - `id` string
        - `image` CoreSocialPojoDtoChatImageDTO
          - `contentType` string
          - `height` integer
          - `size` integer
          - `url` string
          - `width` integer
        - `senderId` string
        - `seq` string
        - `type` string
      - `lastReadSeq` string
      - `peer` CoreSocialPojoDtoSocialUserDTO
        - `avatarUrl` string
        - `blockedByMe` boolean
        - `canMessage` boolean
        - `followerCount` integer
        - `followingCount` integer
        - `friendCount` integer
        - `id` string
        - `introduction` string
        - `messagePermissionReason` string
        - `nickname` string
        - `relationship` string
      - `sendPermissionReason` string
      - `unreadCount` integer
      - `updatedAt` string
    - `nextCursor` string
  - `errorCode` string
  - `message` string
  - `success` boolean

## Other responses

- `400`: Request validation failure; legacy endpoints may still return HTTP 200 with success=false
- `401`: Missing, expired or invalid bearer token
- `403`: Forbidden or privacy restriction
- `429`: Rate limited
- `500`: Server failure; legacy endpoints may still return HTTP 200 with success=false

## Changes

- **2026-10-06** `880521a9d345`: 12 info
  - api operation id `SocialController_listConversations_get__api_social_conversations` was added
  - the endpoint scheme security `bearerAuth` was added to the API
  - api tag `Social` added
  - api tag `community` removed
  - …8 more
- **2026-10-06** `b678383d0162`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/gdeiassistant/apis/gdeiassistant-api/changes/api/social/conversations/get.md)

---

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