---
title: "AI voice-agent conversations (newest first, paginated)"
method: GET
path: "/api/v1/conversations"
---

# AI voice-agent conversations (newest first, paginated)

`GET /api/v1/conversations`

## Request

- Base URL: `https://salestick-backend-647994203646.europe-central2.run.app`
- URL: `https://salestick-backend-647994203646.europe-central2.run.app/api/v1/conversations`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

Conversations handled by the team's Canarics AI agents. Recorded human calls are served by /api/v1/calls instead; a team using only the AI receptionist finds its call history here.

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `limit` integer
- `cursor` string
- `agentId` string
- `direction` 'inbound' | 'outbound'

## Response `200`

Page of conversations

- object
  - `conversations` Conversation[]
    - `id` string
    - `number` string: Caller/callee phone number as delivered by the carrier
    - `agentId` string
    - `direction` 'inbound' | 'outbound'
    - `status` string
    - `createdAt` string, date-time
    - `summary` string: AI-written conversation summary
    - `sentiment` string
    - `score` number: AI quality score
    - `durationSeconds` number
    - `actionTaken` string: What the agent did, e.g. booked_appointment
    - `needsCallback` string: Yes when the customer still needs a human follow-up
    - `clientName` string
  - `cursor` string, nullable
  - `hasMore` boolean

---

[API](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents.md) · [All operations](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/canarics/apis/canarics-api-for-ai-agents/revisions/e89711c2f1ba?raw)