v1

latestOpenAPI 3.1.1Altegio API Agreement2026-08-062032133.5 KB

VoIP Integration

Get Location's Call List

This endpoint is designed to get a list of calls in a location, taking into account filters and pagination

get/voip/integration/calls

Headers

Acceptstring required

e.g. application/vnd.api.v2+json

Request body

salon_idnumber required

Location ID.

date_fromstring required

Start date.

date_tostring required

End date.

phonestring

Phone number.

typesstring[]

Call types list

statusesstring[]

Call statuses list

pagenumber

Page number

limitnumber

Amount of elements on page

Example request

{
  "salon_id": 615243,
  "date_from": "2026-01-01",
  "date_to": "2026-02-01",
  "phone": "+13155550175",
  "types": [
    "incoming",
    "internal"
  ],
  "statuses": [
    "success",
    "cancel"
  ],
  "page": 1,
  "limit": 25
}

Response

Calls list

successboolean

Response status.

metaResponseMetaEmptyObject

Additional response data (empty object or empty array)

Example response

{
  "success": true,
  "data": [
    {
      "id": 8923525,
      "client_id": 51342134,
      "caller_phone": "+13155550175",
      "record_link": "https://records.example.com/somelink.mp3",
      "duration": 244,
      "status": "success",
      "type": "outgoing",
      "call_date": "2026-01-17T23:52:21-05:00"
    },
    {
      "id": 66795308,
      "client_id": 0,
      "caller_phone": "+13155550175",
      "record_link": "",
      "duration": 0,
      "status": "missed",
      "type": "incoming",
      "call_date": "2026-01-17T12:31:12-05:00"
    }
  ]
}