List messages by chat

get

https://api.clint.digital/v2/messages/chat/{chatId}

Retrieve a paginated list of messages for a specific chat (WHATSAPP_OFFICIAL, WHATSAPP or INSTAGRAM). Messages are sorted by created_at descending.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

chatId

uuid

required

UUID of the chat

Query Params

limit

integer

1 to 1000

Defaults to 200

Max number of rows returned

offset

integer

≥ 0

Defaults to 0

Number of rows skipped of the result

page

integer

≥ 1

Defaults to 1

Select the page of the result

content_type

string

enum

Filter messages by content type

Allowed:

created_at_start

date-time

Filter messages whose created_at is greater than or equal to this date (ISO-8601; a bare YYYY-MM-DD is treated as the start of the day). Use for incremental extraction by time window.

created_at_end

date-time

Filter messages whose created_at is less than or equal to this date (ISO-8601). A bare YYYY-MM-DD normalizes to start-of-day, so it excludes that calendar day — pass a full timestamp (e.g. ...T23:59:59Z) to include it.

updated_at_start

date-time

Filter messages whose updated_at is greater than or equal to this date (ISO-8601). updated_at reflects the last change to a message — including delivery/read status changes — so use it to re-fetch messages whose status changed since your last sync.

updated_at_end

date-time

Filter messages whose updated_at is less than or equal to this date (ISO-8601). A bare YYYY-MM-DD normalizes to start-of-day, so it excludes that calendar day — pass a full timestamp (e.g. ...T23:59:59Z) to include it.

Headers

api-token

string

required

API Token

Responses

401

Authentication error - invalid or missing api-token

200A paginated list of messages

400Invalid UUID format