---
title: "Page a tally transcript"
method: GET
path: "/admin/tally/conversations/{id}"
tags: ["Admin"]
---

# Page a tally transcript

`GET /admin/tally/conversations/{id}`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/admin/tally/conversations/{id}`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Requires current site-admin browser session or an admin-agent key satisfying admin:chats:read; admin:read also satisfies it. Admin MCP OAuth does not authenticate this REST route. Detail reads write transcript-access audits, not customer data.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `paged` true, required
- `limit` integer
- `cursor` string
- `reason` string
- `includeMetadata` boolean
- `component` 'messages' | 'turns'

## Response `200`

Bounded live page, stable id ASC ordering, full message content and connected-app diagnostics with credential redaction only. Connected-app use does not hide a conversation from authenticated admins. No lifetime cap. Not a database snapshot; replay changedSince=scanStartedAt with overlap and periodically scan all history for metadata-only edits.

- object
  - `conversations` object[]
  - `conversation` object
  - `messages` object[]
  - `turns` object[]
  - `nextCursor` string, nullable, required
  - `hasMore` boolean, required
  - `coverage` object, required
    - `returned` integer, required
    - `limit` integer, required
    - `order` string, required
    - `scanStartedAt` string, date-time, required
    - `complete` boolean, required: Terminal page; exhaustive only if all earlier pages were consumed.
    - `unresolvedDefinition` string
    - `changedSinceDefinition` string
    - `redacted` boolean

## Other responses

- `400`: Invalid input/cursor
- `401`: Authentication required
- `403`: Admin scope denied
- `404`: Conversation not found

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)