---
title: "Search transcripts"
method: POST
path: "/v1/transcript/project/{projectID}"
tags: ["Transcript", "Public-Docs"]
---

# Search transcripts

`POST /v1/transcript/project/{projectID}`

Search for transcripts matching the specified criteria with pagination.

## Path parameters

- `projectID` string, required — ID of the target Voiceflow project.

## Query parameters

- `take` integer — The maximum number of results to return, used for pagination
- `skip` integer — The number of results to skip, used for pagination.
- `order` 'ASC' | 'DESC' — Used to control the order of the results returned.
- `encode` boolean — Escape HTML special characters that appear in transcripts.

## Request body

- SearchTranscriptsRequest
  - `filters` TranscriptFilter[]
    - union
      - object
        - `id` string, required
        - `op` 'gt' | 'gte' | 'lt' | 'lte', required
        - `value` number, required
      - object
        - `id` string, required
        - `op` 'eq' | 'neq', required
        - `value` union, required
          - string
          - number
          - boolean
      - object
        - `id` string, required
        - `op` 'between', required
        - `value` union[], required
          - union
            - number
            - number
      - object
        - `id` string, required
        - `op` 'in' | 'nin', required
        - `value` union[], required
          - union
            - string
            - number
      - object
        - `id` string, required
        - `op` 'contains', required
        - `value` string, required
      - object
        - `id` string, required
        - `op` 'exists' | 'not_exists', required
      - object
        - `id` string, required
        - `op` 'json_contains', required
        - `value` object[], required
  - `endDate` string, date-time — Select transcripts that were started before a specific date.
  - `sessionID` string — Select transcripts by sessionID.
  - `startDate` string, date-time — Select transcripts that were started after a specific date.
  - `updatedAfter` string, date-time — Select transcripts that were last updated at or after a specific date.
  - `updatedBefore` string, date-time — Select transcripts that were last updated at or before a specific date.
  - `environmentID` union — @deprecated use versionID and projectEnvironmentIDOrAlias instead
    - string
    - VersionTag[]
  - `versionID` string
  - `projectEnvironmentIDOrAlias` string

## Response `200`

- object
  - `transcripts` TranscriptWithMetadataResponse[], required
    - `id` string, required
    - `userID` string, required
    - `sessionID` string, required
    - `projectID` string, required
    - `environmentID` string, required
    - `projectEnvironmentID` string, nullable
    - `createdAt` string, date, required
    - `updatedAt` string, date, required
    - `expiresAt` string, date, nullable, required
    - `endedAt` string, date, nullable, required
    - `recordingURL` string, nullable, required
    - `properties` TranscriptPropertyWithValue[], required
      - `value` string, required
      - `metadata` object, nullable, required
      - `createdAt` string, date, required
      - `updatedAt` string, date, required
      - `id` string, required
      - `name` string, required
      - `type` string, required
      - `default` boolean, required
    - `evaluations` TranscriptEvaluationWithResult[], required
      - union
        - BooleanTranscriptEvaluationWithResult
          - `value` union, required
            - number
            - string
            - boolean
          - `reason` string, required
          - `cost` number, required
          - `createdAt` string, date, required
          - `updatedAt` string, date, required
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `default` boolean, required
          - `type` 'boolean', required
        - NumberTranscriptEvaluationWithResult
          - `value` union, required
            - number
            - string
            - boolean
          - `reason` string, required
          - `cost` number, required
          - `createdAt` string, date, required
          - `updatedAt` string, date, required
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `default` boolean, required
          - `type` 'number', required
          - `maximumValue` number, required
          - `minimumValue` number, required
        - StringTranscriptEvaluationWithResult
          - `value` union, required
            - number
            - string
            - boolean
          - `reason` string, required
          - `cost` number, required
          - `createdAt` string, date, required
          - `updatedAt` string, date, required
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `default` boolean, required
          - `type` 'string', required
        - OptionTranscriptEvaluationWithResult
          - `value` union, required
            - number
            - string
            - boolean
          - `reason` string, required
          - `cost` number, required
          - `createdAt` string, date, required
          - `updatedAt` string, date, required
          - `id` string, required
          - `name` string, required
          - `description` string, nullable, required
          - `default` boolean, required
          - `type` 'option', required
          - `options` TranscriptEvaluationOptionSchema[], required
            - `value` string, required
            - `prompt` string, required
            - `included` boolean, required
            - `color` string, required

---

[API](https://skmtc.dev/voiceflow/apis/general-runtime.md) · [All operations](https://skmtc.dev/voiceflow/apis/general-runtime/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/voiceflow/general-runtime/revisions/6b1c4f778c56/schema)