Call Status Callback

This method allows you to set up your statusURL and to forward every call status.

Your statusURL will be configured in sub account level as a part of the provisioning process.


When receiving status updates for ongoing calls Wavecell platform will POST a JSON object to your URL.

The JSON object will contain the following values:

Name Type Description
sessionId String Unique id represents a call within one or more hops [UUID]
callId String Id unique to a one hop in a call [UUID]
eventType String Event type represents the life cycle status of the call. eg: CALL_INITIATED. Refer Call Event table for all the types.
sourceMsisdn String Number of the calling party in E.164 format i.e the number making the call
targetMsisdn String “Number of the called party in E.164 format i.e the number being call, usually the Virtual Number”,
direction Number “0 for Inbound call, 1 for Outbound call”
referenceId String Your reference provided when configuring the Virtual Number
timestamp timestamp Time stamp of the call event
status String “call status, CONNECTED / NOT_CONNECTED”,
duration Number Call duration in seconds
dtmf Number Applies only if dtmf is being sent
sipStatus Number Sip status code defined in RFC 3261

Additional parameters could be included depending on individual destination or account requirements.

Example of a JSON object sent to your handleURL:

"callId": "a595f7d6-efec-11e9-b999-7bd38233f548", 
"sessionId": "a1d6a5e2-efec-11e9-b999-efc71013a78f",
 "eventType": "CALL_INITIATED",
"direction": 1,
"timestamp": "2019-10-16T08:12:02Z", 
"sourceMsisdn": "6512345678", 
"targetMsisdn": "6587654321",
 "country": "SG",
"status": "NOT_CONNECTED", 
"duration": 7,
"sipStatus": 200,


Your API should respond with 200 OK status.