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

# List transcripts

`POST /transcripts/{dir}`

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
      - 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
    - `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
  - `next_cursor` object, nullable
  - `total_count` integer, required

---

[API](https://skmtc.net/meridianlabs-ai/apis/inspect-scout-viewer-api.md) · [All operations](https://skmtc.net/meridianlabs-ai/apis/inspect-scout-viewer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meridianlabs-ai/inspect-scout-viewer-api/revisions/09cc54e3f328/schema)