Skip to main content
GET
/
call
List calls
curl --request GET \
  --url https://app2.freyavoice.ai/api/v2/call \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "message": "<string>",
    "result": {
      "calls": [
        {
          "id": "<string>",
          "workspaceId": "<string>",
          "assistantId": "<string>",
          "assistantName": "<string>",
          "workflowId": "<string>",
          "workflowName": "<string>",
          "phoneNumberId": "<string>",
          "phoneNumber": "<string>",
          "simulationId": "<string>",
          "campaign": {
            "id": "<string>",
            "name": "<string>"
          },
          "customerNumber": "<string>",
          "startedAt": "<string>",
          "endedAt": "<string>",
          "duration": 123,
          "status": "<string>",
          "type": "<string>",
          "endedReason": "<string>",
          "transcript": "<string>",
          "messages": [
            {
              "role": "<string>",
              "message": "<string>",
              "duration": 123,
              "secondsFromStart": 123,
              "timestamp": "<string>",
              "endTime": 123
            }
          ],
          "summary": "<string>",
          "cost": 123,
          "recordingUrl": "<string>",
          "tags": [
            {
              "tag": "<string>",
              "source": "<string>",
              "value": 123,
              "confidence": 0.5,
              "metadata": {}
            }
          ],
          "customer": {
            "number": "<string>",
            "identity": {
              "firstName": "<string>",
              "lastName": "<string>",
              "email": "<string>"
            }
          },
          "unresolvedProblemsCount": 123,
          "resolvedProblemsCount": 123,
          "unresolvedAiProblemsCount": 123,
          "unresolvedUserProblemsCount": 123,
          "reviewStatus": "<string>",
          "reviewAssignees": [
            {
              "userId": "<string>",
              "userName": "<string>"
            }
          ],
          "isArchived": false
        }
      ],
      "pagination": {
        "total": 123,
        "limit": 123,
        "offset": 123,
        "hasNext": true,
        "hasPrevious": true
      },
      "statusCounts": {
        "all": 123,
        "transferred": 123,
        "successful": 123,
        "failed": 123
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

workspaceId
string<uuid>
required

Workspace identifier

Minimum string length: 1
limit
string
default:20

Page size (defaults to 20)

offset
string
default:0

Offset for pagination

sortBy
enum<string>
default:startedAt

Sort field

Available options:
startedAt,
duration,
sentiment,
relativeTime
sortOrder
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
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
enum<string>
default:active

Filter by archive status

Available options:
active,
all,
archived
export
string

Set to 'true' to return a file export

exportFormat
enum<string>

Export file format

Available options:
csv,
xlsx,
markdown
exportColumns
string

JSON array of column definitions {id,label}

additionalData
string

Comma-separated extras: transcript,cxInsights

Response

Calls with pagination and status counts

success
enum<boolean>
required
Available options:
true,
false
data
object
required