---
title: "List conversations"
method: GET
path: "/v1/conversation"
tags: ["Conversation"]
---

# List conversations

`GET /v1/conversation`

Retrieve a paginated list of conversations for the authenticated subscriber

## Query parameters

- `createdAfter` string
- `createdBefore` string
- `channel` 'voice' | 'chat' | 'email' | 'sms' | 'whatsapp'
- `cursor` string
- `limit` number

## Response `200`

- ConversationListResponseDTO
  - `conversations` ConversationDetailsResponseDTO[], required — The conversations returned in this response
    - `conversationId` object, required — The ID of the conversation
    - `createdAt` string, date-time, required — When the conversation was created (ISO 8601 format)
    - `updatedAt` string, date-time, required — When the conversation was last updated (ISO 8601 format)
    - `transcript` string, required — The transcript of the conversation
    - `customAttributes` object, required — The custom attributes of the conversation
    - `callRecordingLink` string — The link to the call recording if this is a voice ticket and the recording has been processed. The returned URL is a signed URL that will expire in 1 hour
    - `callDuration` number — The duration of the call in milliseconds
    - `summary` string — The summary of the conversation
    - `customer` object — Customer information including email, name, and phone number
    - `tags` string[] — Tags applied to the conversation
    - `csatScore` number — Customer satisfaction score (1-5 rating from customer feedback)
    - `csatCollectedAt` object — When the CSAT score was collected (ISO 8601 format)
  - `nextCursor` object, nullable, required — Cursor for the next page of results, if available

## Changes

- **2026-04-09** `2e7c56c5e808` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/optechai/apis/lorikeet-api/changes/v1/conversation/get.md)

---

[API](https://skmtc.dev/optechai/apis/lorikeet-api.md) · [All operations](https://skmtc.dev/optechai/apis/lorikeet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optechai/lorikeet-api/revisions/415fe1c23342/schema)