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

# List Calls

`GET /v2/calls`

## Query parameters

- `companyId` integer, required
- `cursor` string
- `size` integer
- `startDate` string, datetime
- `endDate` string, datetime
- `state` 'completed' | 'started' | 'ringing' | 'answer' | 'disconnected'
- `children` boolean, nullable

## Response `200`

A paginated collection of calls

- object
  - `meta` object
    - `nextCursor` string
    - `prevCursor` string
  - `data` Call[]
    - `id` integer
    - `parentId` integer, nullable
    - `caller` string — An E164 formatted phone number.
    - `dialed` string — An E164 formatted phone number.
    - `direction` 'inbound' | 'outbound'
    - `status` 'missed' | 'answered' | 'voicemail' | 'hungup'
    - `startedAt` string — An ATOM formatted date time string.
    - `endedAt` string — An ATOM formatted date time string.
    - `answeredAt` string — An ATOM formatted date time string.
    - `forwardNumber` string — An E164 formatted phone number.
    - `answeredBy` string — An E164 formatted phone number.
    - `ringDuration` integer, nullable — The duration of the ring in seconds (for answered calls only)
    - `duration` integer, nullable — The duration of call in seconds. For answered calls, this excludes any ring time. For unanswered or voicemail calls, this number is currently undefined, and will likely be the entire duration of the call. For child calls this is subject to change, but will likely be the entire duration of the leg from start to finish.
    - `disconnectCause` string, nullable — Disconnect cause
    - `disconnectCauseMessage` string, nullable — Disconnect cause message
    - `result` integer — Call result
    - `number` object
      - `id` string
      - `number` string — An E164 formatted phone number.
      - `label` string
      - `tags` object[]
        - `id` integer
        - `name` string
        - `slug` string

---

[API](https://skmtc.dev/800/apis/public-api.md) · [All operations](https://skmtc.dev/800/apis/public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/800/public-api/revisions/aab9efc97342/schema)