Skip to main content
Skip table of contents

List of calls

The history of all calls for all added intercoms.

Calls can have the following statuses:

ring - an ongoing call that has not been answered yet.

answered - a call that is currently being talked on.

ended - a completed call.

missed - a missed call.

GET/api/v1/intercom/calls

Headers

Authorization

Bearer token

Accept

application/json

X-Client

ios-cctv|android-cctv|thick-legal|web

X-UUID

unique device id

Body

per_pagerequired

int

Number of items per pagination page. Default is 25

pagerequired

int

Pagination page number

Response

200

Successful response

JSON
{
    "data": [
        {
            "id": 5546,
            "status": "ended",
            "created_at": "2022-02-04 15:53:04",
            "intercom": {
                "id": 158,
                "title": "test",
                "is_online": false,
                "department": 1,
                "address": "Cameras",
                "camera": {
                    "id": 832,
                    "group_id": 124,
                    "status": "inactive",
                    "type": "media_server_v2",
                    "start_at": "",
                    "created_at": "2022-02-18 15:03:58",
                    "billing_id": null,
                    "pretty_name": "Intercom",
                    "lat": null,
                    "lng": null,
                    "azimuth": null,
                    "is_archive_recording": true,
                    "is_bridge": false,
                    "is_favorite": false,
                    "user_status": "active",
                    "name": "Intercom"
                },
                "created_at": "2021-11-18T11:22:30.000000Z",
                "updated_at": "2022-02-21T15:48:56.000000Z"
            },
            "started_at": "2022-02-04 15:53:07",
            "ended_at": "2022-02-04 15:54:02"
        },
        {
            "id": 2220,
            "status": "missed",
            "created_at": "2021-12-03 14:22:16",
            "intercom": {
                "id": 158,
                "title": "test",
                "is_online": false,
                "department": 1,
                "address": "Cameras",
                "camera": {
                    "id": 832,
                    "group_id": 124,
                    "status": "inactive",
                    "type": "media_server_v2",
                    "start_at": "",
                    "created_at": "2022-02-18 15:03:58",
                    "billing_id": null,
                    "pretty_name": "Intercom",
                    "lat": null,
                    "lng": null,
                    "azimuth": null,
                    "services": {
                        "ptz": false,
                        "motion_detect": false
                    },
                    "is_archive_recording": true,
                    "is_bridge": false,
                    "is_favorite": false,
                    "user_status": "active",
                    "name": "Intercom"
                },
                "created_at": "2021-11-18T11:22:30.000000Z",
                "updated_at": "2022-02-21T15:48:56.000000Z"
            },
            "started_at": null,
            "ended_at": null
        }
    ],
    "links": {
        "first": "https://vms.local/api/v1/intercom/calls?page=1",
        "last": "https://vms.local/api/v1/intercom/calls?page=12",
        "prev": null,
        "next": "https://vms.local/api/v1/intercom/calls?page=2"
    },
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 12,
        "links": [
            {
                "url": null,
                "label": "pagination.previous",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=5",
                "label": "5",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=6",
                "label": "6",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=7",
                "label": "7",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=8",
                "label": "8",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=9",
                "label": "9",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=10",
                "label": "10",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=11",
                "label": "11",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=12",
                "label": "12",
                "active": false
            },
            {
                "url": "https://vms.local/api/v1/intercom/calls?page=2",
                "label": "pagination.next",
                "active": false
            }
        ],
        "path": "https://vms.local/api/v1/intercom/calls",
        "per_page": 15,
        "to": 15,
        "total": 168
    }
}
401

Authorization token not provided or invalid, see Obtaining a token

422

Returns a JSON object with an error, see Validation

JSON
{
    "message": "There won't be any informative message here",
    "errors": {
        "any_key": [
            "Here the error cause will be described"
        ]
    }
}

Example

JSON
curl -k --location --request GET 'https://vms.local/api/v1/intercom/calls?per_page=int&page=int' \
--header 'Authorization:Bearer token' \
--header 'Accept:application/json' \
--header 'X-Client:ios-cctv|android-cctv|thick-legal|web' \
--header 'X-UUID:unique device id'
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.