Messages

List messages across all accounts

Messages across all your accounts, oldest first. Poll with after_cursor = the last next_cursor you received to get only what has arrived since — no gaps, no duplicates. Filter with account_id, chat and since/until (when the message was sent; until is exclusive); include_history adds synced history. Mirrors the wa_list_messages MCP tool.

get/v1/messages

Request

  • Base URL: https://api.whatsmcp.com
  • URL: https://api.whatsmcp.com/v1/messages
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

after_cursorinteger

return messages after this cursor; omit or 0 to start from the beginning

limitinteger

how many to return, 1-200; omit or 0 for 50

account_idstring

only this account's messages; omit for every account

chatstring

only this conversation — a phone number or a group JID

sincestring

only messages sent at or after this time: RFC3339 with a zone, or a date (midnight UTC)

untilstring

only messages sent BEFORE this time (exclusive): one day is since=2026-10-01&until=2026-10-02

include_historyboolean

also return imported history; a page is then in storage order — sort by at

Response

OK

has_moreboolean required

true when the page was full and more may be waiting

next_cursorinteger required

pass this as after_cursor next time to get only newer messages

Changes

No recorded changes to this operation across all 1 revision of this API.