REST API Reference

WAStack provides a secure RESTful API for integrating WhatsApp messaging, webhooks, and session synchronization into your applications. All v1 endpoints are served relative to:

Core Concepts

The API is built around QR-paired device sessions. Each device session proxies an active WhatsApp number. Once paired, you can query chats, contacts, groups, and send messages or media asynchronously.

Rate Limits

Response Payload Formats

All success responses are wrapped inside a standard JSON payload format:

// Success Read Operation (200 OK)
{
  "success": true,
  "data": {
    "id": "device_1",
    "name": "Support Line",
    "phone": "919876543210"
  }
}

// Queued Send Message Operation (202 Accepted)
{
  "success": true,
  "data": {
    "status_code": 202,
    "transactionId": "txn_894103",
    "correlationId": "8f3a2c91-...",
    "messageType": "plain-text"
  }
}

// Error Payload (e.g. 400, 401, 403, 429)
{
  "success": false,
  "error": "Detailed reason why the operation failed."
}