List Stories

Supported & Tested

List status updates visible to the connected WhatsApp account.

POSThttps://api.waplix.io/api/v1/stories/list
Authentication
Authorization: Bearer YOUR_API_KEY
Parameters Specification
instance_id
stringReq

Required Waplix instance id

limit
numberOpt

Optional integer limit

Usage Notes
Verified on production. Public documentation uses sanitized example data only.
Request Payload Example
Request
curl -X POST "https://api.waplix.io/api/v1/api/v1/stories/list" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "instance_id": "demo_instance",
  "limit": 10
}'
Success Response
Response · 200 OK
{
  "success": true,
  "data": {
    "instance_id": "demo_instance",
    "items": [
      {
        "story_id": "STATUS_DEMO_001",
        "chat_id": "status@broadcast",
        "from": "15551234567@s.whatsapp.net",
        "message_type": "image",
        "media_url": "https://example.com/status-image.jpg",
        "timestamp": 1782580000
      }
    ],
    "count": 1
  }
}
Was this page helpful?