Fetch chat history live from WhatsApp

GET 
/api/sessions/:sessionId/messages/:chatId/history

Reads messages directly from the WhatsApp client for the given chat, bypassing the local DB. Useful for retrieving messages that arrived before the gateway was started.

Request

Responses

200

Chat history (most recent messages)

409

The session is not connected — an engine exists for it but is not ready: disconnected, reconnecting, or still initializing, so the request never reached WhatsApp. Wait for ready and retry. A session that was never started answers 400 instead, and the session lifecycle routes answer 409 for a conflicting state rather than this. One window answers this while the session still reads ready: WhatsApp Web periodically reloads its own page and the engine re-injects into it — for those few seconds the answer is a 409 naming the reload; retry shortly.

501

The active engine cannot serve this operation. It is part of the engine contract, but the engine currently running has no implementation for it.

503

The whatsapp-web.js page connection died mid-read, so nothing could be read. Retry once the session is ready again.