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

# List calls

`GET /call`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/call`
- Auth: HTTP bearer

Returns calls for a workspace with filters, sorting, pagination, and export support.

## Query parameters

- `workspaceId` string, uuid, required: Workspace identifier
- `limit` string: Page size (defaults to 20)
- `offset` string: Offset for pagination
- `sortBy` 'startedAt' | 'duration' | 'sentiment' | 'relativeTime': Sort field
- `sortOrder` 'asc' | 'desc': Sort direction
- `callIds` string: Comma-separated list of call IDs
- `startDate` string: Filter calls starting at or after this ISO timestamp
- `endDate` string: Filter calls starting before this ISO timestamp
- `phoneNumberId` string, uuid: Filter by phone number ID
- `customerNumber` string: Filter by customer phone number
- `campaignId` string, uuid: Filter by campaign ID
- `searchTerm` string: Free text search
- `status` string: Filter by call status
- `type` string: Filter by call type
- `endedReason` string: Filter by ended reason
- `filters` string: Base64-encoded filter state
- `includeStatusCounts` string: Set to 'false' to skip status aggregation
- `llmQuery` string: LLM semantic search query - applied before filters
- `archivedFilter` 'active' | 'all' | 'archived': Filter by archive status
- `export` string: Set to 'true' to return a file export
- `exportFormat` 'csv' | 'xlsx' | 'markdown': Export file format
- `exportColumns` string: JSON array of column definitions {id,label}
- `additionalData` string: Comma-separated extras: transcript,cxInsights

## Response `200`

Calls with pagination and status counts

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `calls` object[], required
        - `id` string, required
        - `assistantId` string, nullable
        - `assistantName` string, nullable
        - `workflowId` string, nullable
        - `workflowName` string, nullable
        - `workspaceId` string, required
        - `phoneNumberId` string, nullable
        - `phoneNumber` string, nullable
        - `simulationId` string, nullable
        - `campaign` object, nullable
          - `id` string, required
          - `name` string, required
        - `customerNumber` string, nullable
        - `startedAt` string, nullable
        - `endedAt` string, nullable
        - `duration` number, nullable
        - `status` string, nullable
        - `type` string, nullable
        - `endedReason` string, nullable
        - `transcript` string, nullable
        - `messages` object[], nullable
          - `role` string, required
          - `message` string
          - `duration` number
          - `secondsFromStart` number
          - `timestamp` string
          - `endTime` number
        - `summary` string, nullable
        - `cost` number, nullable
        - `recordingUrl` string, nullable
        - `tags` object[]
          - `tag` string, required
          - `source` string, required
          - `value` number
          - `confidence` number, nullable
          - `metadata` object, nullable
        - `customer` object
          - `number` string, nullable
          - `identity` object
            - `firstName` string
            - `lastName` string
            - `email` string
        - `unresolvedProblemsCount` number
        - `resolvedProblemsCount` number
        - `unresolvedAiProblemsCount` number
        - `unresolvedUserProblemsCount` number
        - `reviewStatus` string, nullable
        - `reviewAssignees` object[], nullable
          - `userId` string, required
          - `userName` string, nullable
        - `isArchived` boolean
      - `pagination` object, required
        - `total` number, required
        - `limit` number, required
        - `offset` number, required
        - `hasNext` boolean, required
        - `hasPrevious` boolean, required
      - `statusCounts` object
        - `all` number, required
        - `transferred` number, required
        - `successful` number, required
        - `failed` number, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)