Sample Request

curl --request GET \
     --url https://api-account-uk.acefone.com/v1/live_calls \
     --header 'accept: application/json'

📘 Important!

Before we begin, note that the * sign denotes the mandatory variables in each table.

Request Variables (Query Params)

The following parameter is required to fetch details of active calls.

Variable Name	Description	Data Type
agent_number	Number of the agent.	string
extension	Extension of the agent.	string
did_number	Number from which the call is routed from.	string
call_id	Unique ID of the call.	string

Sample Response

[
  {
    "id": 793133114,
    "user_id": 10959,
    "client_id": null,
    "call_id": "1714657799.11930963",
    "direction": 2,
    "source": "+9198999998829",
    "type": "click-to-call",
    "did": "+9180889990031",
    "multiple_destination_type": "c2c",
    "multiple_destination_name": "SIP/+20607011215773",
    "destination": "+917011215773,+917011215773",
    "state": "Answered",
    "queue_state": null,
    "channel_id": "SIP/TATA-BLR-UNLIMITED-8069182000_6163f238316cf-0077db44",
    "created_at": "2024-05-03 00:49:59",
    "sip_domain": "192.168.5.25",
    "broadcast_id": null,
    "broadcast_no": null,
    "call_time": "00:00:33",
    "agent_name": "XYZ",
    "customer_number": "20607011215773"
  }
]

Response Variables

The response returned is as following:

Variable Name	Description	Data Type
id	ID of the call	Integer
user_id	Customer's unique ID	Integer
client_id	Customer's client ID	String
call_id	Unique ID of call	String
direction	Direction of call [1: inbound, 2: outbound]	Integer
source	Number from where call originated	String
type	Type of call	String
did	Caller ID shown to customer	String
multiple_destination_type	Type of multi-destination call. [ eg: Click to call (c2c) ]	String
multiple_destination_name	Number for multi-destination call	String
destination	Destination number for call	String
state	Call's current state	String
queue_state	Call’s state while waiting in queue.	String
channel_id	Channel ID	String
created_at	Start stamp of call	String
sip_domain	Sip domain for call	String
broadcast_id	Unique ID of broadcast	String
broadcast_no	Lead's number	String
call_time	Duration of call	String
agent_name	Agent's name	String
customer_number	Customer number at which the call was directed.	String