curl "https://core.wadial.com/api/v1/sessions/{sessionId}/events" \
-H "Authorization: Bearer $WADIAL_API_KEY" \
-H "Accept: text/event-stream"
API Reference
Stream events
Subscribe to live token events with Server-Sent Events.
GET
/
api
/
v1
/
sessions
/
{sessionId}
/
events
curl "https://core.wadial.com/api/v1/sessions/{sessionId}/events" \
-H "Authorization: Bearer $WADIAL_API_KEY" \
-H "Accept: text/event-stream"
Use this stream when your app needs live token updates while the token is connecting, pairing, sending, receiving, or calling.
The response is a Server-Sent Events stream. Each event uses the WADial event name as the SSE
WADial also sends heartbeat comments every 30 seconds:
Live SSE events include:
Pairing QR:
Inbound message:
Outgoing send result:
Call state:
Call and recording events carry metadata only. Raw call audio is only available on the call media WebSocket.
string
required
Token id returned by
POST /api/v1/sessions.curl "https://core.wadial.com/api/v1/sessions/{sessionId}/events" \
-H "Authorization: Bearer $WADIAL_API_KEY" \
-H "Accept: text/event-stream"
event, the event id as the SSE id, and a JSON data object.
id: 019f...
event: message.receipt
data: {"sessionId":"019eff5e-e24e-74ce-a9bb-ccd97e6946b6","createdAt":"2026-06-29T17:10:00.000Z","messageIds":["3EB0..."],"status":"read"}
: heartbeat
session.createdsession.deletedconnection.stateauth.qrauth.pairing_requiredauth.pairing_codeauth.pairedmessage.receivedmessage.sentmessage.receiptmessage.failedcall.incomingcall.statecall.endedcall.errorcall.recording.readystanza.errorstream.failure
auth.pairing_required and auth.pairing_code are live stream events only. Use the token timeline or webhooks for persisted and retryable event delivery.
Common payloads
Connection state:{
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"createdAt": "2026-06-29T17:10:00.000Z",
"status": "open"
}
{
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"createdAt": "2026-06-29T17:10:00.000Z",
"qr": "2@...",
"ttlMs": 20000
}
{
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"createdAt": "2026-06-29T17:10:00.000Z",
"key": {
"remoteJid": "[email protected]",
"id": "3EB0A1B2C3D4E5F6",
"fromMe": false
},
"timestampSeconds": 1782753000,
"pushName": "Jane",
"message": {
"conversation": "Hello"
}
}
{
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"createdAt": "2026-06-29T17:10:00.000Z",
"messageId": "3EB0A1B2C3D4E5F6",
"to": "[email protected]",
"contentType": "text"
}
{
"sessionId": "019eff5e-e24e-74ce-a9bb-ccd97e6946b6",
"createdAt": "2026-06-29T17:10:00.000Z",
"callId": "call-123",
"peerJid": "[email protected]",
"direction": "incoming",
"mediaType": "audio",
"state": "active",
"transport": "websocket"
}
Was this page helpful?