---
title: "List transcripts"
method: POST
path: "/transcripts/{dir}"
tags: ["transcripts"]
---

# List transcripts

`POST /transcripts/{dir}`

## Request

- The document declares no server URL.
- Auth: none declared

Returns transcripts from specified directory. Optional filter condition uses SQL-like DSL. Optional order_by for sorting results. Optional pagination for cursor-based pagination.

## Path parameters

- `dir` string, required: Transcripts directory (base64url-encoded)

## Request body

- TranscriptsRequest: Request body for POST /transcripts endpoint.
  - `filter` Condition: WHERE clause condition that can be combined with others.
    - `is_compound` boolean, required
    - `left` union
      - string
      - Condition (recursive)
    - `operator` union
      - '=' | '!=' | '<' | '<=' | '>' | '>=' | 'IN' | 'NOT IN' | 'LIKE' | 'NOT LIKE' | 'ILIKE' | 'NOT ILIKE' | 'IS NULL' | 'IS NOT NULL' | 'BETWEEN' | 'NOT BETWEEN': SQL comparison operators.
      - 'AND' | 'OR' | 'NOT': Logical operators for combining conditions.
    - `right` union
      - Condition (recursive)
      - union[]
        - union
          - string
          - integer
          - number
          - boolean
          - string, date-time
          - string, date
      - unknown[]
        - unknown
      - string
      - integer
      - number
      - boolean
      - string, date-time
      - string, date
  - `order_by` union
    - OrderBy
      - `column` string, required
      - `direction` 'ASC' | 'DESC', required
    - OrderBy[]
      - `column` string, required
      - `direction` 'ASC' | 'DESC', required
  - `pagination` Pagination
    - `cursor` object, nullable
    - `direction` 'forward' | 'backward', required
    - `limit` integer, required

## Response `200`

Successful Response

- TranscriptsResponse
  - `items` TranscriptInfo[], required
    - `agent` string, nullable
    - `agent_args` object, nullable
    - `date` string, nullable
    - `error` string, nullable
    - `limit` string, nullable
    - `message_count` integer, nullable
    - `metadata` object, required
    - `model` string, nullable
    - `model_options` object, nullable
    - `score` unknown
    - `score_explanation` string, nullable
    - `source_id` string, nullable
    - `source_type` string, nullable
    - `source_uri` string, nullable
    - `success` boolean, nullable
    - `task_id` string, nullable
    - `task_repeat` integer, nullable
    - `task_set` string, nullable
    - `total_time` number, nullable
    - `total_tokens` integer, nullable
    - `transcript_id` string, required
    - `trust_content` boolean, nullable
  - `next_cursor` object, nullable
  - `total_count` integer, required

## Changes

- **2026-10-09** `624af02c270c`: 1 info
  - added the optional property `items/items/trust_content` to the response with the `200` status
- **2026-09-04** `a9ec569047af`: 1 info
  - added the optional property `items/items/score_explanation` to the response with the `200` status
- **2026-04-03** `0fc41a5c1e02`: 1 info
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7` from the `items/items/score/anyOf[#/components/schemas/JsonValue]/` response property `oneOf` list for the response status `200`
- **2026-03-17** `d2a0b9f760ff`: 1 breaking
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6, subschema #7` to the `items/items/score/anyOf[#/components/schemas/JsonValue]/` response property `oneOf` list for the response status `200`

[Operation history](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/changes/transcripts/:dir/post.md)

---

[API](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api.md) - [All operations](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meridianlabs-ai/apis/inspect-scout-viewer-api/revisions/b799e9a81653?raw)