ReferenceChatsGet Chat / Message History

Get Chat / Message History

POSThttps://public.leadpattern.com/chats/conversation

application/json60 req/min

Retrieve the paginated message history for a single conversation.

A POST used as a read — the filters travel in the body.

Headers

1 field

Authorizationstring

required

Your API key. Sent raw (e.g. 'lp_...'). No Bearer prefix required.

Body Parameters

4 fields

waIdstring

required

Contact WhatsApp ID.

pagenumber

optionaldefault: 1

Page number.

limitnumber

optionaldefault: 20

Messages per page.

searchstring

optional

Search within message bodies.

Responses

JSON Response

{
  "type": "success",
  "data": [
    {
      "messageId": "wamid.abc123",
      "direction": "incoming",
      "type": "text",
      "message": {
        "body": "Hello"
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalCount": 1
  }
}

Sample Request Body

{
  "waId": "9195XXXXXXXX",
  "page": 1,
  "limit": 20
}