Skip to main content
GET
/
v1
/
v2
/
conversations
/
{conversation_id}
/
turns
List a v2 conversation's transcript
curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/v2/conversations/{conversation_id}/turns \
  --header 'x-api-key: <api-key>'
{
  "turns": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "session_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "content": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "tool_calls": [
        {
          "id": "<string>",
          "function": {
            "name": "<string>",
            "arguments": "<string>"
          },
          "type": "function"
        }
      ],
      "tool_results": {
        "tool_call_id": "<string>",
        "output": "<string>",
        "error": "<string>"
      },
      "model_used": "<string>",
      "token_count": {
        "input_tokens": 123,
        "output_tokens": 123,
        "total_tokens": 123
      },
      "latency_ms": 123,
      "is_compacted": false,
      "metadata": {},
      "delivery_status": "<string>",
      "authored_by": "<string>",
      "evidence": {
        "package_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "conversation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "turn_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "created_at": "2023-11-07T05:31:56Z",
        "items": [
          {
            "citation_marker": "<string>",
            "label": "<string>",
            "short_label": "<string>",
            "document_title": "<string>",
            "version_number": 123,
            "section": {
              "path_titles": [
                "<string>"
              ],
              "path_numbers": [
                "<string>"
              ],
              "display_label": "<string>",
              "confidence": "unknown"
            },
            "deep_link": "<string>"
          }
        ],
        "view": "display",
        "schema_version": 1,
        "message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
conversation_id
string<uuid>
required

Query Parameters

​
limit
integer
default:50
Required range: x <= 200
​
cursor
string | null
​
role
string | null
​
include_compacted
boolean
default:true

Include rows folded into the rolling summary by compaction; folded rows carry is_compacted=true so clients can badge them.

​
include_evidence
boolean
default:false

[ENG-670 T3] Attach each row's evidence package (the KB sources shown to the model). Off by default — the hot read DEFERS the large citations column; opt in to load and project it.

​
evidence_view
enum<string>
default:full

Serialization view when include_evidence=true. The transcript default is 'full' (staff/audit — raw scores, hashes, chunk ids, status_reason); 'display' is the end-user source-card subset. (The live-turn surface defaults to 'display' instead.)

Available options:
display,
full

Response

Successful Response

​
turns
TurnResponse · object[]
required
​
has_more
boolean
required
​
next_cursor
string | null