---
title: "List conversations (v2)"
method: GET
path: "/api/v1/research/conversations-v2"
tags: ["research"]
---

# List conversations (v2)

`GET /api/v1/research/conversations-v2`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/research/conversations-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`)

List Research interviews (one respondent's conversation each), newest first, each with its accepted answers coded (tone, tags, chosen options, a ranking's order, a scale's rating, a task's success), optionally narrowed to one campaign, a segment scope, and respondents who gave given answers (a chosen option or a coded tone). With campaignId it also names the campaign's study questions and counts the interviews before the answer filters. Pass the returned nextCursor with the same campaignId, segments and answer filters to continue after the last interview listed, at any page size; interviews that arrive mid-walk never shift a page, and nextCursor is null on the last page.

## Query parameters

- `limit` integer: Interviews per page (default 20, max 100).
- `cursor` string: Opaque nextCursor from a previous call; the page continues after the last interview that call listed. Send the same campaignId, customerId and segments to continue the same list.
- `campaignId` string, uuid: Only this Research campaign's interviews; omit for every campaign.
- `customerId` string, uuid: Only this customer's interviews; omit for every customer.

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- ResearchConversationsListV2Response
  - `data` object[], required
    - `id` string, uuid, required
    - `respondent` string, required
    - `study` 'ad_copy' | 'brand_health' | 'offers' | 'pricing' | 'product' | 'product_launch' | 'sales' | 'custom' | 'product_roadmap' | 'purchasing' | 'competitors', required: The Research study type the campaign runs.
    - `campaignName` string, required
    - `questionCount` integer, required
    - `status` 'scheduled' | 'waiting' | 'running' | 'completed' | 'failed' | 'cancelled', nullable, required
    - `completedAt` string, date-time, nullable, required
  - `nextCursor` string, nullable, required
  - `totalCount` integer, required
  - `segments` object[]: The segments the list was read under, when the request named any; an entry is labeled only on a first page (no cursor) with a campaignId.
    - `axis` 'audience' | 'channel' | 'market' | 'age' | 'householdIncome' | 'education' | 'lifeStage' | 'areaType' | 'companySize' | 'buyerRole' | 'seniority' | 'occupation' | 'job' | 'triggerType' | 'intentStage' | 'language' | 'gender' | 'store' | 'customer', required
    - `id` string, required
    - `label` string: The entry's name as research.campaign-segments.get.v1 lists it (audience, channel and store entries only); absent for any other axis or for a member the campaign's active roster does not hold.

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