---
title: "List active calls"
method: GET
path: "/self/calls"
tags: ["Calls"]
---

# List active calls

`GET /self/calls`

Lists currently active calls

## Query parameters

- `fromDate` integer
- `toDate` integer
- `direction` 'INBOUND' | 'OUTBOUND'
- `states` 'INITIALIZING' | 'RINGING' | 'ACTIVE' | 'HELD' | 'REMOTE_HELD'
- `offset` integer
- `size` integer
- `order` 'DESC' | 'ASC'
- `sort` string

## Response `200`

Successful

- Call[]
  - `accountId` integer, required — Unique identifier of the account
  - `answerTime` string, date — Time to answer the call
  - `callerId` string — Remote caller ID
  - `direction` 'INBOUND' | 'OUTBOUND', required — Direction of the call
  - `duration` integer, required — Duration of the call in milliseconds
  - `endTime` string, date — End time of the call
  - `externalId` string — External identifier of the call
  - `id` integer, required — Unique identifier of the call
  - `phoneNumber` string, required — Unique identifier of the account
  - `startTime` string, date, required — Start time of the call
  - `state` 'INITIALIZING' | 'RINGING' | 'ACTIVE' | 'HELD' | 'REMOTE_HELD' | 'DETACHED' | 'REJECTED' | 'CANCELLED' | 'ANSWERED' | 'MISSED', required — Status of the call
  - `type` 'CALL', required — Record type
  - `uciId` integer, required — Unique identifier of communications provider
  - `userId` integer, required — Unique identifier of the user

## Other responses

- `400` — Bad Request: The client should not repeat the request without modifications
- `401` — Unauthorized: Invalid access token
- `403` — Forbidden: The user has no rights to access the resource(s)
- `408` — Timeout: The client may repeat the request without modifications
- `422` — Validation Error
- `500` — Internal Server Error
- `502` — Bad Gateway

---

[API](https://skmtc.net/vonage/apis/vgis.md) · [All operations](https://skmtc.net/vonage/apis/vgis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vonage/vgis/versions/343ef79f45ec/schema)