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 Name	Type	Description
*appid	number	Your app id.
*secret	string	Your app secret.
start_date	number	The timestamp of start date and time in UTC timezone. By default the timestamp will be last 24 hours from current time.
end_date	number	The timestamp of end date and time in UTC timezone. By default the timestamp will be current time.
page	number	As a default, the first page will be displayed, and each page will have 10 records.
limit	number	The 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.

Property	Type	Description
count	number	The total count of call detail record(cdr).
cdr	JSON array	The list of total cdr in detail.
cmiuid	string	A unique identifier for this call.
duration	number	The total duration of the call in seconds when it was initiated.
notes	JSON array	The entire notes information of the caller or calle.
msg	string	The notes information of the caller or calle.
date	number	A timestamp indicates the time the notes were added in the UTC timezone.
agent	string	The user ID for the added notes.
billedsec	number	The total duration of the call in seconds when it was missed.
rate	number	The calling cost of the phone call.
name	string	The name of the caller.
from	number	The call was made from this number.
to	number	Your DID number.
time	number	A 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 code	Status code	Description
200	OK	There was a successful response to your request.
404	Error	Authentication Failed.
400	Error	Parameter missing.