Reading

List messages

GET/v1/messages

The main way to read history. Returns messages newest first, with optional filters.

Request

GET https://api.api-supp.com/v1/messages

Param	Type	Default	Notes
`chat_jid`	string	—	One conversation. Phone and LID forms both work
`since`	string	—	Messages at or after this time
`before`	string	—	Messages at or before this time
`q`	string	—	Text search in the message content (case-insensitive)
`sender`	string	—	Exact sender
`media_type`	string	—	`image`, `video`, `audio`, `document`, `sticker` (also `poll_vote`, see polls)
`is_from_me`	bool	—	`true` sent by you, `false` received
`include_groups`	bool	`false`	Groups are left out unless you set this
`limit`	int	`100`	Max 1000
`offset`	int	`0`

bash

curl "https://api.api-supp.com/v1/messages?chat_jid=14155550132%40s.whatsapp.net&limit=20" \
  -H "Authorization: Bearer wat_YOUR_TOKEN"

Response

json

{ "messages": [ /* each with id, chat_jid, sender, content, timestamp, is_from_me, chat_name, media fields */ ], "count": 42, "limit": 100, "offset": 0 }

Search works per request; there is no global index, so very large histories get slower.