Get Chat Messages

Get historical chat messages with pagination.

HTTP Request

GET /api/v3/fiat/retrieveChatMessageWithPagination

Required Permission: P2P Deal Order, P2P Deal Ad

Request Parameters

Name	Type	Mandatory	Description
conversationId	integer	yes	Conversation ID
page	integer	yes	Page number, starting from 1
limit	integer	yes	Records per page, default 20, max 50
chatMessageType	string	no	Message type filter: `text`, `image`, `file`, `video`
id	integer	no	Message ID (when set, queries single message details)
sort	string	no	Sort order: `DESC` (default) or `ASC`

Response Parameters

Name	Type	Description
totalPage	integer	Total pages
total	integer	Total records
messages	array	Message list
messages[].id	integer	Message ID
messages[].conversationId	integer	Conversation ID
messages[].content	string	Text message content
messages[].type	integer	Message type: 1=text, 2=image, 3=video, 4=file
messages[].imageUrl	string	Image URL
messages[].imageThumbUrl	string	Image thumbnail URL
messages[].videoUrl	string	Video URL
messages[].fileUrl	string	File URL
messages[].createTime	string	Send time
messages[].fromUserId	string	Sender ID
messages[].fromNickName	string	Sender nickname
messages[].self	boolean	Whether sent by self

Response

{
  "msg": "success",
  "code": 0,
  "data": {
    "totalPage": 1,
    "total": 1,
    "messages": [
      {
        "id": 1,
        "conversationId": 50012,
        "content": "hello",
        "type": 1,
        "imageUrl": "",
        "imageThumbUrl": "",
        "videoUrl": "",
        "fileUrl": "",
        "createTime": "2025-01-26 12:00:00",
        "fromUserId": "abc123",
        "fromNickName": "Merchant A",
        "self": true
      }
    ]
  }
}