---
title: "List problems"
method: GET
path: "/problems"
tags: ["Problems"]
---

# List problems

`GET /problems`

## Request

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

Returns problems for a workspace with filters, sorting, pagination, and histogram data.

## Query parameters

- `workspaceId` string, uuid, required: Workspace ID
- `callId` string, uuid: Filter by specific call ID
- `granularity` '1h' | '24h' | 'week' | 'month' | 'year': Histogram bucket granularity
- `startDate` string: Start date for histogram (ISO format)
- `endDate` string: End date for histogram (ISO format)
- `archivedFilter` 'active' | 'all' | 'archived': Filter by archive status
- `limit` string: Page size
- `offset` string: Offset for pagination
- `filters` string: Base64-encoded filter state
- `search` string: Global search term
- `sortBy` string: Sort field name
- `sortOrder` 'asc' | 'desc': Sort direction
- `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}

## Response `200`

Problems with pagination and summary

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `success` boolean, required
      - `problems` object[], required
        - `id` string
        - `workspaceId` string, nullable
        - `callId` string, nullable
        - `agentId` string, nullable
        - `problem` string, required
        - `description` string, nullable
        - `type` 'system' | 'audio' | 'transcription' | 'decision' | 'general' | 'null', nullable
        - `severity` number
        - `status` string
        - `assignedTo` string, nullable
        - `createdBy` string
        - `messageId` string, nullable
        - `resolved` boolean
        - `resolvedAt` string, nullable
        - `resolvedBy` string, nullable
        - `solutionId` string, uuid, nullable
        - `createdAt` string
        - `updatedAt` string
        - `callStartedAt` string, nullable
        - `customerNumber` string, nullable
        - `agentName` string, nullable
        - `resolvedByName` string, nullable
        - `assignees` object[]
          - `userId` string, required
          - `userName` string, nullable
          - `assignedAt` string, required
        - `commentsCount` number
        - `isArchived` boolean
      - `pagination` object, required
        - `total` number, required
        - `limit` number, required
        - `offset` number, required
      - `summary` object, required
        - `total` number, required
        - `resolved` number, required
        - `unresolved` number, required
        - `byType` object, required
          - `system` number, required
          - `audio` number, required
          - `transcription` number, required
          - `decision` number, required
          - `general` number
        - `byStatus` object
      - `histogram` object[]
        - `timestamp` string, required
        - `total` number, required
        - `resolved` number, required
        - `unresolved` number, required
        - `filteredTotal` number, required
        - `filteredResolved` number, required
        - `filteredUnresolved` number, required
      - `uniqueStatuses` string[]

## 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)