Skip to main content

Incoming Missed

Each API request in TeleCMI platform includes App id and secret. Get your App id and secret in TeleCMI dashboard. After getting the app id and secret, make a POST request to the below base URL to retrieve the incoming missed call details.

Base URL

Send your POST method request with valid parameters, to the following base URL.

https://rest.telecmi.com/v2/missed

Sample JSON Request

Below is the following sample JSON POST method request.

{
"appid": 1111112,
"secret": "xxxx-xxxx-xxxx-xxx",
"start_date": 1649238593000,
"end_date": 1654509008000,
"page": 2,
"limit": 5
}

Required Parameters

These are the required POST method parameters with a description.

Parameter NameTypeDescription
*appidnumberYour app id.
*secretstringYour app secret.
start_datenumberThe timestamp of start date and time in UTC timezone. By default the timestamp will be last 24 hours from current time.
end_datenumberThe timestamp of end date and time in UTC timezone. By default the timestamp will be current time.
pagenumberAs a default, the first page will be displayed, and each page will have 10 records.
limitnumberThe number of records per request is 10 by default limit, but can be increased to a maximum limit of 20.
Note
The * marked parameter is mandatory.

Sample Response

If the provided information is valid, your web server will get a sample response from the TeleCMI Platform as given below.

{
"count": 187,
"cdr": [
{
"cmiuid": "8b5f88dd-0396-4f9d-907f-7807275d2def",
"duration": 4,
"notes": [
{
"msg": "Technical Support",
"date": 1650625184759,
"agent": "302_1111112"
}
],
"billedsec": 4,
"rate": 1,
"name": "unknown",
"from": 442000000001,
"to": 442000000002,
"time": 1654507446464
},
{
"cmiuid": "415d6b66-38c0-46b1-ad8c-ed70f2fb83d9",
"duration": 4,
"notes": [
{
"msg": "Product Support",
"date": 1650625184759,
"agent": "302_1111112"
}
],
"billedsec": 3,
"rate": 1,
"name": "unknown",
"from": 442000000001,
"to": 442000000003,
"time": 1654506297200
},
{
"cmiuid": "a0d05193-5cb0-4fe6-9328-ccffc8e1607c",
"duration": 6,
"billedsec": 5,
"rate": 1,
"name": "unknown",
"from": 191700000000,
"to": 442000000004,
"time": 1654327145933
},
{
"cmiuid": "6357c345-0201-4df4-9cd3-e7a8bf50b012",
"duration": 9,
"billedsec": 8,
"rate": 1,
"name": "unknown",
"from": 19170000001,
"to": 442000000005,
"time": 1654327129126
},
{
"cmiuid": "e4f385d5-d74c-423f-be22-6f1db781f033",
"duration": 5,
"billedsec": 4,
"rate": 1,
"name": "unknown",
"from": 919100000000,
"to": 442000000006,
"time": 1654148251825
}
],
"code": 200
}

Properties

This is the list of properties and their descriptions.

PropertyTypeDescription
countnumberThe total count of call detail record(cdr).
cdrJSON arrayThe list of total cdr in detail.
cmiuidstringA unique identifier for this call.
durationnumberThe total duration of the call in seconds when it was initiated.
notesJSON arrayThe entire notes information of the caller or calle.
msgstringThe notes information of the caller or calle.
datenumberA timestamp indicates the time the notes were added in the UTC timezone.
agentstringThe user ID for the added notes.
billedsecnumberThe total duration of the call in seconds when it was missed.
ratenumberThe calling cost of the phone call.
namestringThe name of the caller.
fromnumberThe call was made from this number.
tonumberYour DID number.
timenumberA timestamp indicates the time the call was missed in the UTC timezone.

HTTP status codes

The TeleCMI API platform represents the following status code to identify the errors.

Status codeStatus codeDescription
200OKThere was a successful response to your request.
404ErrorAuthentication Failed.
400ErrorParameter missing.