Get paginated messages for a specific thread

GET

/openapi/message/pagedthreadmessages/{threadId}

const url = 'https://open-api.replyco.com/openapi/message/pagedthreadmessages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0?page=1&count=10&asc=false';
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/message/pagedthreadmessages/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0?page=1&count=10&asc=false' \
  --header 'Authorization: Bearer <token>'

Returns messages for a thread with pagination support. Includes message previews optimized for display in UI.

Default sort order:

asc=true: Oldest messages first (chronological)
asc=false: Newest messages first (reverse chronological)

Pagination limits:

Default page size: 50
Maximum page size: 100

Note: This endpoint returns MessagePreviewModel which is lighter than the full message object returned by /threadMessages/{threadId}

Authorizations

Bearer

Parameters

Path Parameters

threadId

required

string format: uuid

Thread 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)

asc

boolean

Sort order: true for chronological, false for reverse chronological (default: false)

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

text

string

nullable

messageDate

string format: date-time

nullable

sendingDate

string format: date-time

nullable

status

integer format: int32

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

isFromCompany

boolean

nullable

languageCode

string

nullable

failMessage

string

nullable

attachmentUrls

string

nullable

userId

string format: uuid

nullable

isDelayed

boolean

autoresponseId

string format: uuid

nullable

templateId

string format: uuid

nullable

autoresponseName

string

nullable

templateName

string

nullable

senderAddress

string

nullable

ccStr

string

nullable

bccStr

string

nullable

totalRecords

integer format: int32

translatedText

string

nullable

translatedTo

string

nullable

toneScore

number format: double

nullable

toneReason

string

nullable

Array<string>

nullable

bcc

Array<string>

nullable

Example

{
  "totalRecords": 2,
  "pageSize": 50,
  "pagesCount": 1,
  "currentPage": 1,
  "data": [
    {
      "id": "4f6b2d81-9e3c-47a5-b2d0-8c1e5a7f3b69",
      "text": "Hi Jane, sorry to hear that. Could you send us a photo of the parcel?",
      "messageDate": "2026-10-20T15:12:00Z",
      "isFromCompany": true
    },
    {
      "id": "1a9c4e72-3b5d-4e8f-a061-5d7b2c9e8f14",
      "text": "My parcel arrived damaged. Photo attached.",
      "messageDate": "2026-10-20T14:05:00Z",
      "isFromCompany": false
    }
  ]
}

400

Invalid pagination parameters

401

User is not authenticated or authorized

403

User does not have access to this thread

404

Thread with the specified ID was not found