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

- `customerId` string
- `dateFrom` string
- `dateTo` string
- `cursor` string
- `limit` number

## Response `200`

- ConversationListResponseDTO
  - `conversations` ConversationDetailsResponseDTO[], required — The conversations returned in this response
    - `conversationId` object, required — The ID of the conversation
    - `type` 'Live' | 'Test', required — Whether the conversation is a real live conversation or a test 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)
    - `remoteTicketId` object, nullable — ID of the ticket in the external ticketing system (e.g. Zendesk ticket ID). Null for first-party channels.
  - `nextCursor` object, nullable, required — Cursor for the next page of results, if available

## Changes

- **2026-05-13** `0a5817fe60b9` — 2 info
  - added the optional property `conversations/items/remoteTicketId` to the response with the `200` status
  - added the required property `conversations/items/type` to the response with the `200` status
- **2026-04-13** `7d1529fa7f68` — 3 warning, 3 info
  - deleted the `query` request parameter `channel`
  - deleted the `query` request parameter `createdAfter`
  - deleted the `query` request parameter `createdBefore`
  - added the new optional `query` request parameter `customerId`
  - …2 more
- **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/789c7fa93584/schema)