Get paginated messages for a specific chat

GET

/openapi/chat/pagedchatmessages/{chatId}

const url = 'https://open-api.replyco.com/openapi/chat/pagedchatmessages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0?page=1&count=10&asc=true';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://open-api.replyco.com/openapi/chat/pagedchatmessages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0?page=1&count=10&asc=true' \
  --header 'Authorization: Bearer <token>'

Returns all messages in a live chat conversation with pagination. Messages are ordered chronologically by default.

Search capabilities:

Message content
Sender name

Pagination limits:

Default page size: 50
Maximum page size: 100

Authorizations

Bearer

Parameters

Path Parameters

chatId

required

string format: uuid

Chat ID to retrieve messages from

Query Parameters

page

integer format: int32

default: 1

Page number (default: 1, min: 1)

count

integer format: int32

default: 10

Items per page (default: 50, min: 1, max: 100)

term

string

Search term for filtering messages

sort

string

Field name to sort by

asc

boolean

default: true

Sort order: true for ascending, false for descending (default: true)

Responses

200

Returns the paginated message list

application/json

object

totalRecords

integer format: int32

pageSize

integer format: int32

pagesCount

integer format: int32

currentPage

integer format: int32

data

Array<object>

nullable

object

string format: uuid

marketId

string

nullable

text

string

nullable

date

string format: date-time

senderMarketId

string

nullable

unread

boolean

forwardFromName

Name of customer, which message was forwarded

string

nullable

replyMessageId

Market id of replied message

string

nullable

type

integer format: int32

Allowed values: 0 - Text 1 - Sticker 2 - Photo 3 - Document 4 - Video 5 - VideoNote 6 - Audio 7 - Animation 8 - Voice 9 - InstagramStoryReply 10 - InstagramStoryMention 11 - Location 12 - Reaction 13 - Image 14 - Unknown 15 - Button 16 - Interactive 17 - Order 18 - System 19 - Failed 20 - Unsupported

status

integer format: int32

Allowed values: 0 - SentSuccesfully 1 - InProgress 2 - Failed 3 - Cancelled 4 - Delayed

isFromCompany

boolean

language

integer format: int32

Allowed values: 0 - None 1 - Arabic 2 - Chinese 3 - Danish 4 - Dutch 5 - English 6 - French 7 - German 8 - Greek 9 - Hindi 10 - Italian 11 - Japanese 12 - Korean 13 - Norwegian 14 - Polish 15 - Portuguese 16 - Russian 17 - Spanish 18 - Swedish 19 - Turkish 20 - Ukrainian

sendingDate

string format: date-time

nullable

userId

string format: uuid

nullable

chatId

string format: uuid

customerId

string format: uuid

nullable

autoresponseId

string format: uuid

nullable

files

It could be audio, sticker, photo…

Array<object>

nullable

object

string format: uuid

marketFileId

External marketplace-specific file identifier (if applicable)

string

nullable

mimeType

MIME type of the file (e.g., “image/png”, “application/pdf”)

string

nullable

fileSize

Size of the file in bytes

integer format: int32

fileName

Name of the file including extension (e.g., “logo.png”, “document.pdf”)

string

nullable

filePath

Server-side path where the file is stored (internal use)

string

nullable

fileUrl

Publicly accessible URL to download/view the file

string

nullable

base64

Base64-encoded file content for inline upload/download

string

nullable

Example

{
  "totalRecords": 1,
  "pageSize": 50,
  "pagesCount": 1,
  "currentPage": 1,
  "data": [
    {
      "id": "6d1b8f3a-4e9c-42b7-9a5d-1f8e3c6b2d70",
      "chatId": "2e7f4a96-8b1c-4d3e-a5f7-9c2b6e4d1a83",
      "text": "Hi, can I still change the delivery address for my order?",
      "date": "2026-10-21T08:42:00Z",
      "isFromCompany": false,
      "unread": true
    }
  ]
}

400

Invalid pagination parameters

401

User is not authenticated or authorized

404

Chat with the specified ID was not found