v1

latestOpenAPI 3.1.02026-07-1413113265.9 KB

story

[BETA] get stories

Retrieves all available stories/status updates that are visible to the authenticated user. This includes both viewed and unviewed stories from contacts. Note: This endpoint is currently in beta and may change without notice.

post/instances/{id}/client/action/get-stories

Path parameters

idinteger required

Instance ID

Response

Successfully retrieved stories

status'success' | 'error'

instanceIdstring

Example response

{
  "status": "success",
  "instanceId": "1",
  "data": {
    "stories": [
      {
        "id": {
          "server": "c.us",
          "user": "1234567890",
          "_serialized": "1234567890@c.us"
        },
        "timestamp": 1732860512,
        "totalCount": 1,
        "unreadCount": 1,
        "msgs": [
          {
            "mediaKey": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX=",
            "id": {
              "remote": {
                "server": "broadcast",
                "user": "status",
                "_serialized": "status@broadcast"
              },
              "participant": {
                "server": "c.us",
                "user": "1234567890",
                "_serialized": "1234567890@c.us"
              }
            },
            "type": "video",
            "timestamp": 1732860512,
            "from": "status@broadcast",
            "to": "1234567890@c.us",
            "author": "1234567890@c.us"
          }
        ]
      }
    ],
    "textStatuses": [
      {
        "id": {
          "server": "c.us",
          "user": "1234567890",
          "_serialized": "1234567890@c.us"
        },
        "status": "Hey there!."
      }
    ]
  },
  "links": {
    "self": "https://waapi.app/api/v1/instances/1/client/action/get-stories"
  }
}