---
title: "Get Location's Call List"
method: GET
path: "/voip/integration/calls"
tags: ["VoIP Integration"]
---

# Get Location's Call List

`GET /voip/integration/calls`

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

## Headers

- `Accept` string, required

## Request body

- object
  - `salon_id` number, required — Location ID.
  - `date_from` string, required — Start date.
  - `date_to` string, required — End date.
  - `phone` string — Phone number.
  - `types` string[] — Call types list
  - `statuses` string[] — Call statuses list
  - `page` number — Page number
  - `limit` number — Amount of elements on page

## Response `200`

Calls list

- object
  - `success` boolean — Response status.
  - `data` object[] — Calls list
    - `id` integer — Call ID
    - `client_id` integer — Client ID (if there is a client in Clients Base)
    - `caller_phone` string — Phone number
    - `record_link` string — Link to call recording (if available)
    - `duration` integer — Call duration in seconds
    - `status` 'success' | 'missed' | 'cancel' | 'busy' | 'notallowed' | 'notavailable' | 'notfound' — Call status
    - `type` 'incoming' | 'outgoing' | 'internal' — Call type
    - `call_date` string — Date and time of call
  - `meta` ResponseMetaEmptyObject — Additional response data (empty object or empty array)

## Other responses

- `401` — Partner token not passed.
- `403` — No access (requires the right to view "Overview - Calls").

---

[API](https://skmtc.dev/alteg/apis/developer-tools.md) · [All operations](https://skmtc.dev/alteg/apis/developer-tools/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/alteg/developer-tools/revisions/c89b6494ffd2/schema)