Load older messages

Asks the engine to pull older history from the connected phone for chats that haven't been fully synced yet.

Use this before paginating with since if you need messages older than what's already cached. Optionally pull several pages in one call via pages (WA-paced ~2.5s apart) and/or stop at a target depth via until_date; the response reports how far back the chat is now loaded under coverage. Requires chats:read.

Request

curl -X POST "https://api.blueticks.co/v1/messages/load_older/" \  -H "Content-Type: application/json" \  -d '{}'

{
  "success": true,
  "data": {
    "totalMessages": 0,
    "added": 0,
    "canLoadMore": true,
    "historyUnavailable": true,
    "error": "string",
    "pagesExecuted": 0,
    "coverage": {
      "oldestLoadedTimestamp": 0,
      "oldestLoadedIso": "string"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "string",
    "message": "string",
    "requestId": "string",
    "details": [
      {
        "path": "string",
        "code": "string",
        "message": "string"
      }
    ]
  }
}

Path Parameters

chatId*string

Request Body

application/json

pages?integer

How many older pages to pull in one call (1-10, default 1). Pages are WA-paced ~2.5s apart. Stops early on exhaustion, error, or reaching until_date.

Range1 <= value <= 10

until_date?|

Stop once the oldest loaded message is at/before this date (ISO 8601 string or epoch seconds/ms). Lets you page back to a target depth deterministically.

Load older messages

Request

Path Parameters

Request Body

Response

Response Body

`application/json`

`application/json`

Load older messages

Request

Path Parameters

Request Body

Response

Response Body

200application/json

Error codesapplication/json

`application/json`

`application/json`