---
title: "Page all tally conversations"
method: GET
path: "/admin/tally/conversations"
tags: ["Admin"]
---

# Page all tally conversations

`GET /admin/tally/conversations`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/admin/tally/conversations`
- 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.

## Query parameters

- `paged` true, required
- `limit` integer
- `cursor` string
- `firmOrganizationId` string, uuid
- `companyOrganizationId` string, uuid
- `changedSince` string, date-time
- `changedBefore` string, date-time
- `createdBefore` string, date-time
- `resolution` 'all' | 'unresolved'

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

---

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