Calls module
Endpoints for making and managing phone calls
GET
/calls Returns collection of Live Call resources
Parameters
No parameters
Example Request
GET /v1.1/voipstudio/calls HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
401 Unauthorized
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": 4155,
"clid": "value",
"connected_at": 1467408162,
"context": "value",
"destination": 2,
"dst": "44203846719",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 5.17,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 5.17,
"dst_ua": "value",
"duration": 7039,
"min_charge": 7.13,
"monitor_state": 2,
"parent_id": 8297,
"referred_by": "value",
"src": "32179243705",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 3.33,
"src_ua": "value",
"start_time": 1657537681,
"state": 3
}
],
"total": 59
}
POST
/calls Make a call to number in e164 format
Parameters
JSON body attributes:
to string
Destination number in e164 format
Destination number in e164 format
from string
User ID from which call should originate (Optional)
User ID from which call should originate (Optional)
caller_id string
Caller ID to use for the call. E164 number or 'anonymous' (Optional)
Caller ID to use for the call. E164 number or 'anonymous' (Optional)
Example Request
POST /v1.1/voipstudio/calls HTTP/1.1
Host: l7api.com
{
"to": "12123455483",
"from": "12341",
"caller_id": "442036427900"
}
Responses
201 Created
400 Validation error
401 Unauthorized
400 Validation error
401 Unauthorized
Example Response
HTTP/1.1 201 OK
Content-Type: application/json
{
"data": {
"id": 5868,
"clid": "value",
"connected_at": 1658795046,
"context": "value",
"destination": 2,
"dst": "12124537768",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 4.2,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 6.2,
"dst_ua": "value",
"duration": 8989,
"min_charge": 8.2,
"monitor_state": 2,
"parent_id": 378,
"referred_by": "value",
"src": "12124537768",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 8.33,
"src_ua": "value",
"start_time": 1651050680,
"state": 2
},
"links": {}
}
GET
/calls/{id} Returns Live Call resource for given Id
Parameters
Endpoint URL:
{id} integerCall identifier
Example Request
GET /v1.1/voipstudio/calls/64 HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
403 Access denied
404 Resource not found
401 Unauthorized
403 Access denied
404 Resource not found
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": 2439,
"clid": "value",
"connected_at": 1462904816,
"context": "value",
"destination": 2,
"dst": "13103345244",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 9.17,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 9.13,
"dst_ua": "value",
"duration": 235,
"min_charge": 5.2,
"monitor_state": 1,
"parent_id": 184,
"referred_by": "value",
"src": "32179243705",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 2.1,
"src_ua": "value",
"start_time": 1550314054,
"state": 3
},
"links": {}
}
PATCH
/calls/{id} Transfers existing Call resource to given e164 number
Parameters
Endpoint URL:
{id} integerCall identifier
JSON body attributes:
dst string
Destination number in e164 format
Destination number in e164 format
state string
Change call state, for example Answer ringing call
Change call state, for example Answer ringing call
labels array
action_url string
Attach action URL to this call
Attach action URL to this call
action_text string
Text to be displayed for action_url link
Text to be displayed for action_url link
monitor_state string
Allows to start, pause and resume call monitoring (recording)
Allows to start, pause and resume call monitoring (recording)
Example Request
PATCH /v1.1/voipstudio/calls/62 HTTP/1.1
Host: l7api.com
{
"dst": "12123455483",
"state": "answer",
"labels": "abcd",
"action_url": "https://my-crm.com/contact/id",
"action_text": "Click here for contact details",
"monitor_state": "M"
}
Responses
301 Moved permanently
400 Validation error
401 Unauthorized
403 Access denied
404 Resource not found
400 Validation error
401 Unauthorized
403 Access denied
404 Resource not found
Example Response
HTTP/1.1 301 OK
Content-Type: application/json
{
"data": {
"id": 8604,
"clid": "value",
"connected_at": 1597170320,
"context": "value",
"destination": 0,
"dst": "44203846719",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 2.17,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 7.14,
"dst_ua": "value",
"duration": 6688,
"min_charge": 6.13,
"monitor_state": 0,
"parent_id": 2206,
"referred_by": "value",
"src": "12124537768",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 5.33,
"src_ua": "value",
"start_time": 1469911851,
"state": 2
},
"links": {}
}
DELETE
/calls/{id} Terminates ongoing Live Call
Parameters
Endpoint URL:
{id} integerCall identifier
Example Request
DELETE /v1.1/voipstudio/calls/7 HTTP/1.1 Host: l7api.com
Responses
204 Success
401 Unauthorized
403 Access denied
404 Resource not found
401 Unauthorized
403 Access denied
404 Resource not found
Example Response
HTTP/1.1 204 OK
GET
/calls/{id}/trace Returns collection of Call trace resources
Parameters
Endpoint URL:
{id} integerCall identifier
Example Request
GET /v1.1/voipstudio/calls/10/trace HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
401 Unauthorized
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": 6813,
"clid": "value",
"connected_at": 1618283406,
"context": "value",
"destination": 2,
"dst": "12124537768",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 6.1,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 3.33,
"dst_ua": "value",
"duration": 3938,
"min_charge": 3.13,
"monitor_state": 1,
"parent_id": 5207,
"referred_by": "value",
"src": "44203844711",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 6.1,
"src_ua": "value",
"start_time": 1493773918,
"state": 2
},
"links": {}
}
GET
/calls/{id}/monitors Returns collection of Call monitor resources
Parameters
Endpoint URL:
{id} integerCall identifier
Example Request
GET /v1.1/voipstudio/calls/67/monitors HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
401 Unauthorized
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": 2031,
"clid": "value",
"connected_at": 1719629365,
"context": "value",
"destination": 1,
"dst": "12124537768",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 5.5,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 9.17,
"dst_ua": "value",
"duration": 3119,
"min_charge": 3.14,
"monitor_state": 0,
"parent_id": 2717,
"referred_by": "value",
"src": "32179243705",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 8.14,
"src_ua": "value",
"start_time": 1700068501,
"state": 2
},
"links": {}
}
GET
/webcalls Returns Webcall resources
Parameters
No parameters
Example Request
GET /v1.1/voipstudio/webcalls HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
401 Unauthorized
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": 9433,
"calldate": "2017-06-26 00:28:06",
"charge": 4.2,
"from": "44779243705",
"from_charge": 5.25,
"from_duration": 2347,
"from_rate": 8.17,
"to": "44779243705",
"to_charge": 4.2,
"to_duration": 1375,
"to_rate": 7.1
}
],
"total": 59
}
POST
/webcalls Make a webcall from e164 number to other e164 number or extemsion
Parameters
JSON body attributes:
from string
Source number in e164 format
Source number in e164 format
to string
Destination number in e164 format or extension
Destination number in e164 format or extension
Example Request
POST /v1.1/voipstudio/webcalls HTTP/1.1
Host: l7api.com
{
"from": "12123455483",
"to": "12123455483"
}
Responses
201 Created
400 Validation error
401 Unauthorized
400 Validation error
401 Unauthorized
Example Response
HTTP/1.1 201 OK
Content-Type: application/json
{
"data": {
"id": 3331,
"calldate": "2021-10-19 20:32:51",
"charge": 3.17,
"from": "44203844711",
"from_charge": 9.17,
"from_duration": 9462,
"from_rate": 3.14,
"to": "32179243705",
"to_charge": 5.14,
"to_duration": 6285,
"to_rate": 4.13
},
"links": {}
}
POST
/leadcalls Make a leadcall from user to e164 number
Parameters
JSON body attributes:
caller_id string
Caller ID
Caller ID
to string
Destination number in e164 format or extension
Destination number in e164 format or extension
tts string
Example Request
POST /v1.1/voipstudio/leadcalls HTTP/1.1
Host: l7api.com
{
"caller_id": "12123455483",
"to": "12123455483",
"tts": "abcd"
}
Responses
201 Created
400 Validation error
401 Unauthorized
400 Validation error
401 Unauthorized
Example Response
HTTP/1.1 201 OK
Content-Type: application/json
{
"data": {
"id": 1995,
"clid": "value",
"connected_at": 1721700490,
"context": "value",
"destination": 2,
"dst": "44203844711",
"dst_call_id": "value",
"dst_codec": "value",
"dst_connection": 2.1,
"dst_contact": "value",
"dst_id": "value",
"dst_name": "value",
"dst_rate": 9.11,
"dst_ua": "value",
"duration": 613,
"min_charge": 3.17,
"monitor_state": 3,
"parent_id": 7677,
"referred_by": "value",
"src": "44203846719",
"src_call_id": "value",
"src_codec": "value",
"src_contact": "value",
"src_id": "value",
"src_name": "value",
"src_rate": 4.1,
"src_ua": "value",
"start_time": 1520432399,
"state": 2
},
"links": {}
}
GET
/mediasessions Returns collection of Media Session resources
Parameters
No parameters
Example Request
GET /v1.1/voipstudio/mediasessions HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
401 Unauthorized
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": [
{
"id": 6551,
"call_id": "value",
"created_at": "2019-09-24 01:06:59",
"dst_id": "value",
"dst_ua": "value",
"duration": 6241,
"src_id": "value",
"src_ua": "value",
"status": "value",
"type": "value",
"updated_at": "2019-09-24 01:01:54",
"user": 9720
}
],
"total": 59
}
GET
/mediasessions/{id} Returns Media Session resource for given Id
Parameters
Endpoint URL:
{id} integerMediaSession identifier
Example Request
GET /v1.1/voipstudio/mediasessions/50 HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
403 Access denied
404 Resource not found
401 Unauthorized
403 Access denied
404 Resource not found
Example Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": 7326,
"call_id": "value",
"created_at": "2016-10-01 02:34:19",
"dst_id": "value",
"dst_ua": "value",
"duration": 7971,
"src_id": "value",
"src_ua": "value",
"status": "value",
"type": "value",
"updated_at": "2016-10-01 02:39:35",
"user": 4830
},
"links": {}
}
GET
/calllabels Returns collection of CallLabel resources
Parameters
No parameters
Example Request
GET /v1.1/voipstudio/calllabels HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
401 Unauthorized
Example Response
POST
/calllabels Creates new CallLabel resource
Parameters
Example Request
POST /v1.1/voipstudio/calllabels HTTP/1.1 Host: l7api.com
Responses
201 Created
400 Validation error
400 Validation error
Example Response
GET
/calllabels/{id} Returns CallLabel resource for given Id
Parameters
Endpoint URL:
{id} integerCallLabel identifier
Example Request
GET /v1.1/voipstudio/calllabels/51 HTTP/1.1 Host: l7api.com
Responses
200 Success
401 Unauthorized
403 Access denied
404 Resource not found
401 Unauthorized
403 Access denied
404 Resource not found
Example Response
PATCH
/calllabels/{id} Updates existing CallLabel resource
Parameters
Endpoint URL:
{id} integerCallLabel identifier
Example Request
PATCH /v1.1/voipstudio/calllabels/45 HTTP/1.1 Host: l7api.com
Responses
200 Success
400 Validation error
404 Resource not found
400 Validation error
404 Resource not found
Example Response
DELETE
/calllabels/{id} Deletes existing CallLabels resources
Parameters
Endpoint URL:
{id} integerCallLabel identifier
Example Request
DELETE /v1.1/voipstudio/calllabels/94 HTTP/1.1 Host: l7api.com
Responses
204 Success
401 Unauthorized
403 Access denied
404 Resource not found
401 Unauthorized
403 Access denied
404 Resource not found
Example Response
HTTP/1.1 204 OK