# Get Location's Call List

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

Endpoint: GET /voip/integration/calls
Version: 1.0.0
Security: BearerPartnerUser

## Security:

  - `BearerPartnerUser` (unknown)
    http bearer Bearer {PartnerToken}, User {UserToken}

## Header parameters:

  - `Accept` (string, required)
    e.g. application/vnd.api.v2+json

## Request fields (application/json):

  - `salon_id` (number, required)
    Location ID.
    Example: 615243

  - `date_from` (string, required)
    Start date.
    Example: 2026-01-01

  - `date_to` (string, required)
    End date.
    Example: 2026-02-01

  - `phone` (string)
    Phone number.
    Example: +13155550175

  - `types` (array)
    Call types list
    Example: ["incoming","internal"]

  - `statuses` (array)
    Call statuses list
    Example: ["success","cancel"]

  - `page` (number)
    Page number
    Example: 1

  - `limit` (number)
    Amount of elements on page
    Example: 25

## Response 200:

  - `200` (unknown)
    Calls list

## Response 200 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: true

  - `data` (array)
    Calls list

  - `data.id` (integer)
    Call ID

  - `data.client_id` (integer)
    Client ID (if there is a client in Clients Base)

  - `data.caller_phone` (string)
    Phone number

  - `data.record_link` (string)
    Link to call recording (if available)

  - `data.duration` (integer)
    Call duration in seconds

  - `data.status` (string)
    Call status
    Enum: "success", "missed", "cancel", "busy", "notallowed", "notavailable", "notfound"

  - `data.type` (string)
    Call type
    Enum: "incoming", "outgoing", "internal"

  - `data.call_date` (string)
    Date and time of call

  - `meta` (object | array)
    Additional response data (empty object or empty array)
    Example: {}

## Response 401:

  - `401` (unknown)
    Partner token not passed.

## Response 401 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Authentication needed.

## Response 403:

  - `403` (unknown)
    No access (requires the right to view "Overview - Calls").

## Response 403 fields (application/json):

  - `success` (boolean)
    Response status.
    Example: false

  - `data` (object | null)
    Response data.
    Example: null

  - `meta` (object)
    Additional response data.

  - `meta.message` (string)
    Error message.
    Example: Access denied.