---
title: "List conversation previews (v2)"
method: GET
path: "/api/v1/discovery/conversation-previews-v2"
tags: ["discovery"]
deprecated: true
---

# List conversation previews (v2)

`GET /api/v1/discovery/conversation-previews-v2`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/discovery/conversation-previews-v2`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

> **Deprecated.**

Deprecated: use discovery.conversation-previews.list.v3 (discovery_conversation_previews_list_v3), which names no faviconLightUrl or faviconDarkUrl: a favicon is one image for both themes, faviconUrl. This version answers the same and names both, never sent. List the newest conversations of a campaign's results window (dated in the 30 days ending its as-of day, `scope.window`) as previews, at most 12, optionally narrowed to segments: each customer's name and job title or age, the assistant, when it happened, the brands it named and their role, and its first turns. Of those, the ones held in the campaign's language come first, newest first within each group: the campaign's language is its profile's, else English, and a customer who declares no language speaks it. A campaign without results answers its state and no previews. Page through and search every conversation with discovery_conversations_list_v2.

## Query parameters

- `limit` integer: Number of previews to return (1–12)
- `cursor` string: Opaque cursor returned as nextCursor by the previous page
- `campaignId` string, uuid, required: Discovery campaign id.
- `dateRange` string, nullable: Result window: `all`, a preset id, or `yyyy-MM-dd..yyyy-MM-dd`. Omit for the campaign's default window.
- `segments` string[]: Narrows the read to these segments, ANDed: one `axis:id` per axis (any number of distinct `customer:` entries), in canonical axis order. Empty reads the whole dispatch.

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- DiscoveryConversationPreviewsListV2Response
  - `data` object[], required
    - `customerId` string, required
    - `customerName` string, required
    - `customerSubtitle` string, required: The customer's job title, else their age; empty when neither is known.
    - `conversation` object, required
      - `id` string, required
      - `campaignId` string, required
      - `campaignName` string, required
      - `engine` string, required: The assistant's name, e.g. ChatGPT.
      - `engineId` string, required: The assistant's provider id, e.g. openai.
      - `occurredAt` string, required: ISO timestamp the conversation started.
      - `scoring` object, nullable, required: The brands the conversation named, in order; null when it named none.
        - `brands` object[], required
          - `id` string, required
          - `name` string, required
          - `color` string, nullable, required
          - `role` 'target' | 'competitor' | 'other', required
      - `turns` object[], required: The conversation's first turns.
        - `id` string, required
        - `role` 'user' | 'assistant', required: `user` is the customer; `assistant` the AI.
        - `body` string, required
        - `at` string, nullable: ISO timestamp, when the transcript kept one.
        - `label` string: The speaker: the customer's name or the assistant's.
        - `sources` object[]
          - `url` string, required
          - `title` string, nullable
          - `siteName` string, nullable
          - `faviconUrl` string, nullable
          - `faviconLightUrl` unknown
          - `faviconDarkUrl` unknown
          - `faviconTone` 'dark' | 'light' | 'mixed' | 'unknown', nullable
          - `faviconTransparent` boolean, nullable
          - `faviconNeedsLightBackplate` boolean, nullable
          - `faviconNeedsDarkBackplate` boolean, nullable
        - `searchQueries` string[]
  - `nextCursor` string, nullable, required
  - `scope` DiscoveryScope, required
    - `campaignId` string, required
    - `state` 'ready' | 'running' | 'failed' | 'out-of-range' | 'no-campaign', required: `ready` carries results; every other state carries none.
    - `failureReason` string, nullable, required
    - `perspective` object, nullable, required: The brand lens applied; null when the report honors no lens or carries no results.
      - `brand` string, required: The brand the results were read as.
      - `isOwnBrand` boolean, required: Whether that brand is the campaign's own.
    - `window` object, nullable, required: The results window; null unless `state` is `ready`.
      - `from` string, date, required: The first UTC day a trend plots: the range's, never before the first interaction.
      - `to` string, date, required: The last UTC day a trend plots: the range's end, never past today.
      - `asOf` string, date, required: The UTC day every single value is as of: its value is the average over the campaign's interactions dated in the 30 days ending with it. The range's end, or, when those 30 days hold none, the last day with an interaction.
      - `comparedTo` string, date, required: The day a change compares with: 30 days before asOf.
      - `interactionCount` integer, required: The interactions dated in the 30 days ending asOf, under the scope.
      - `customerCount` integer, required: The distinct customers of those interactions.

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

[API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/36a84c7aca11?raw)