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

# List calls

`GET /v1/calls`

Returns a paginated list of calls scoped to the workspaces accessible by the API key. Use the `workspaceIds` query parameter to narrow results to a subset of those workspaces.

## Query parameters

- `page` number
- `limit` number
- `sort` string
- `filters` string
- `workspaceIds` string

## Response `200`

Paginated list of calls

- PaginatedCallDTO
  - `data` CallWithContactDTO[], required
    - `id` string, required — Unique identifier of the call history entry
    - `callType` 'CALL_SESSION' | 'DIRECT_CALL', required — Type of the call history entry (e.g., CALL_SESSION, DIRECT_CALL)
    - `phoneNumberId` string — Unique identifier of the phone number used for the call
    - `userProviderSid` string — Provider SID for the user side of the call
    - `adminProviderSid` object, nullable — Provider SID for the admin side of the call
    - `providerConferenceId` string — Provider conference ID
    - `status` string, required — Status of the call
    - `type` string, required — Type of call (e.g., outbound, inbound)
    - `transferred` boolean — Indicates if the call was transferred
    - `startedAt` object, nullable, required — Start time of the call
    - `endedAt` object, nullable, required — End time of the call
    - `createdAt` string, date-time, required — Date and time when the call history entry was created
    - `updatedAt` string, date-time — Date and time when the call history entry was last updated
    - `sequenceRunId` string — Unique identifier of the related sequence run
    - `sequenceId` string — Unique identifier of the parent sequence
    - `syncedWithCrmDate` object, nullable — Date and time when the call was synced with CRM
    - `deletedAt` string, date-time, nullable — Date and time when the call history entry was deleted
    - `organizationId` string — Unique identifier of the organization
    - `organizationMembershipId` string — Unique identifier of the organization membership
    - `managedPhoneNumberId` string — Unique identifier of the managed phone number
    - `notes` string — Notes associated with the call
    - `contact` CallContactSummaryDTO, required
      - `id` string, required — Unique identifier of the contact
      - `firstName` string, required — First name of the contact
      - `lastName` string, required — Last name of the contact
      - `isUnknown` boolean, required — Whether this is an unknown contact (not in the system)
    - `phoneNumber` CallPhoneNumberSummaryDTO, required
      - `value` string, required — The phone number value
    - `caller` CallCallerSummaryDTO, required
      - `firstName` string, required — First name of the caller
      - `lastName` string, required — Last name of the caller
    - `callerPhoneNumber` CallPhoneNumberSummaryDTO, required
      - `value` string, required — The phone number value
  - `total` number, required
  - `page` number, required
  - `limit` number, required
  - `totalPages` number, required

## Other responses

- `401` — Invalid or missing API key
- `403` — One or more requested workspaceIds are outside the API key scope

---

[API](https://skmtc.net/skipcall/apis/skipcall-public-api.md) · [All operations](https://skmtc.net/skipcall/apis/skipcall-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skipcall/skipcall-public-api/versions/f594352719bd/schema)