Blueticks
Scheduled Messages

List scheduled messages

List messages in the user-messages queue (all sources: API, dashboard, extension), newest first (offset-paginated).

Optionally filter by chatId and/or lifecycle status.

Request

curl -X GET "https://api.blueticks.co/v1/scheduled-messages"
GET
/v1/scheduled-messages

Query Parameters

chatId?string

Filter to messages addressed to this chat. Accepts +E164 / bare digits / any WhatsApp id; normalized to <phone>@c.us to match the recipient stored on the queued/scheduled doc.

searchToken?string

Search token; when set, only items whose name matches are returned.

Length1 <= length <= 200
status?string

Filter by lifecycle status: pending (accepted, waiting), confirmed (WhatsApp accepted — has waMessageKey), received (double grey tick), read (double blue tick), played (voice played), failed.

Value in"pending" | "before-wa-send" | "bt-sent" | "sending" | "sent" | "sent_pending_ack" | "confirmed" | "delivered" | "received" | "read" | "played" | "cancelled" | "error" | "failed" | "expired"
includeSent?boolean

Include messages that were already SENT and therefore soft-deleted (default false). A cancelled message is never included. Pair with chatId to answer "what has this contact already been sent?".

Defaultfalse
includePreview?boolean

Include the link-preview thumbnail image (default false). Title, description and url are always returned; only the embedded image is omitted.

Defaultfalse
order?string

Sort direction by timestamp: asc (oldest first) or desc (newest first, default).

Default"desc"
Value in"asc" | "desc"
skip?integer

Number of items to skip before the page (default 0).

Default0
Range0 <= value
limit?integer

Page size (1-200, default 50).

Default50
Range1 <= value <= 200

Response

Response Body

application/json

application/json