> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voiceflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search transcripts

> Search for transcripts matching the specified criteria with pagination.



## OpenAPI

````yaml /specs/analytics/openapi.public.json post /v1/transcript/project/{projectID}
openapi: 3.0.0
info:
  title: Analytics
  description: Voiceflow analytics service
  version: 1.0.0
  contact: {}
servers:
  - url: https://analytics-api.voiceflow.com
security: []
paths:
  /v1/transcript/project/{projectID}:
    post:
      tags:
        - Transcript
        - Public-Docs
      summary: Search transcripts
      description: Search for transcripts matching the specified criteria with pagination.
      operationId: TranscriptPublicController_searchByProjectID_v1
      parameters:
        - name: projectID
          required: true
          in: path
          description: ID of the target Voiceflow project.
          schema:
            description: ID of the target Voiceflow project.
            type: string
        - name: take
          required: false
          in: query
          schema:
            description: The maximum number of results to return, used for pagination
            type: integer
            minimum: 1
            exclusiveMinimum: false
            maximum: 100
            exclusiveMaximum: false
            default: 25
        - name: skip
          required: false
          in: query
          schema:
            description: The number of results to skip, used for pagination.
            type: integer
            minimum: 0
            exclusiveMinimum: false
            default: 0
        - name: order
          required: false
          in: query
          schema:
            description: Used to control the order of the results returned.
            type: string
            enum:
              - ASC
              - DESC
            x-enumNames:
              - ASC
              - DESC
            default: DESC
        - name: encode
          required: false
          in: query
          schema:
            description: Escape HTML special characters that appear in transcripts.
            type: boolean
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              properties:
                filters:
                  description: >-
                    Filter transcripts based on properties and evaluation
                    results.
                  type: array
                  maxItems: 50
                  items:
                    oneOf:
                      - type: object
                        properties:
                          id:
                            type: string
                          op:
                            type: string
                            enum:
                              - gt
                              - gte
                              - lt
                              - lte
                          value:
                            type: number
                        required:
                          - id
                          - op
                          - value
                      - type: object
                        properties:
                          id:
                            type: string
                          op:
                            type: string
                            enum:
                              - eq
                              - neq
                          value:
                            oneOf:
                              - oneOf:
                                  - type: string
                                  - type: number
                              - type: boolean
                        required:
                          - id
                          - op
                          - value
                      - type: object
                        properties:
                          id:
                            type: string
                          op:
                            type: string
                            enum:
                              - between
                          value:
                            type: array
                            items:
                              oneOf:
                                - type: number
                                - type: number
                        required:
                          - id
                          - op
                          - value
                      - type: object
                        properties:
                          id:
                            type: string
                          op:
                            type: string
                            enum:
                              - in
                              - nin
                          value:
                            type: array
                            items:
                              oneOf:
                                - type: string
                                - type: number
                        required:
                          - id
                          - op
                          - value
                      - type: object
                        properties:
                          id:
                            type: string
                          op:
                            type: string
                            enum:
                              - contains
                          value:
                            type: string
                        required:
                          - id
                          - op
                          - value
                      - type: object
                        properties:
                          id:
                            type: string
                          op:
                            type: string
                            enum:
                              - exists
                              - not_exists
                        required:
                          - id
                          - op
                endDate:
                  description: Select transcripts that were started before a specific date.
                  type: string
                  format: date-time
                sessionID:
                  description: Select transcripts by sessionID.
                  type: string
                startDate:
                  description: Select transcripts that were started after a specific date.
                  type: string
                  format: date-time
                environmentID:
                  description: >-
                    @deprecated use versionID and projectEnvironmentIDOrAlias
                    instead 
                  oneOf:
                    - type: string
                    - type: array
                      minItems: 1
                      maxItems: 2
                      items:
                        type: string
                        enum:
                          - development
                          - staging
                          - production
                        x-enumNames:
                          - Development
                          - Staging
                          - Production
                versionID:
                  type: string
                projectEnvironmentIDOrAlias:
                  type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  transcripts:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        userID:
                          type: string
                        sessionID:
                          type: string
                        projectID:
                          type: string
                        environmentID:
                          type: string
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
                        expiresAt:
                          type: string
                          format: date-time
                          nullable: true
                        endedAt:
                          type: string
                          format: date-time
                          nullable: true
                        recordingURL:
                          type: string
                          nullable: true
                        properties:
                          type: array
                          items:
                            type: object
                            properties:
                              value:
                                type: string
                              metadata:
                                type: object
                                additionalProperties: {}
                                nullable: true
                              createdAt:
                                type: string
                                format: date-time
                              updatedAt:
                                type: string
                                format: date-time
                              id:
                                type: string
                              name:
                                type: string
                              type:
                                type: string
                              default:
                                type: boolean
                            required:
                              - value
                              - metadata
                              - createdAt
                              - updatedAt
                              - id
                              - name
                              - type
                              - default
                        evaluations:
                          type: array
                          items:
                            oneOf:
                              - type: object
                                properties:
                                  value:
                                    oneOf:
                                      - type: number
                                      - type: string
                                      - type: boolean
                                  reason:
                                    type: string
                                  cost:
                                    type: number
                                  createdAt:
                                    type: string
                                    format: date-time
                                  updatedAt:
                                    type: string
                                    format: date-time
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  default:
                                    type: boolean
                                  type:
                                    type: string
                                    enum:
                                      - boolean
                                required:
                                  - value
                                  - reason
                                  - cost
                                  - createdAt
                                  - updatedAt
                                  - id
                                  - name
                                  - description
                                  - default
                                  - type
                              - type: object
                                properties:
                                  value:
                                    oneOf:
                                      - type: number
                                      - type: string
                                      - type: boolean
                                  reason:
                                    type: string
                                  cost:
                                    type: number
                                  createdAt:
                                    type: string
                                    format: date-time
                                  updatedAt:
                                    type: string
                                    format: date-time
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  default:
                                    type: boolean
                                  type:
                                    type: string
                                    enum:
                                      - number
                                  maximumValue:
                                    type: number
                                  minimumValue:
                                    type: number
                                required:
                                  - value
                                  - reason
                                  - cost
                                  - createdAt
                                  - updatedAt
                                  - id
                                  - name
                                  - description
                                  - default
                                  - type
                                  - maximumValue
                                  - minimumValue
                              - type: object
                                properties:
                                  value:
                                    oneOf:
                                      - type: number
                                      - type: string
                                      - type: boolean
                                  reason:
                                    type: string
                                  cost:
                                    type: number
                                  createdAt:
                                    type: string
                                    format: date-time
                                  updatedAt:
                                    type: string
                                    format: date-time
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  default:
                                    type: boolean
                                  type:
                                    type: string
                                    enum:
                                      - string
                                required:
                                  - value
                                  - reason
                                  - cost
                                  - createdAt
                                  - updatedAt
                                  - id
                                  - name
                                  - description
                                  - default
                                  - type
                              - type: object
                                properties:
                                  value:
                                    oneOf:
                                      - type: number
                                      - type: string
                                      - type: boolean
                                  reason:
                                    type: string
                                  cost:
                                    type: number
                                  createdAt:
                                    type: string
                                    format: date-time
                                  updatedAt:
                                    type: string
                                    format: date-time
                                  id:
                                    type: string
                                  name:
                                    type: string
                                  description:
                                    type: string
                                    nullable: true
                                  default:
                                    type: boolean
                                  type:
                                    type: string
                                    enum:
                                      - option
                                  options:
                                    type: array
                                    items:
                                      type: object
                                      properties:
                                        value:
                                          type: string
                                          minLength: 1
                                          maxLength: 100
                                        prompt:
                                          type: string
                                          minLength: 1
                                          maxLength: 10000
                                        included:
                                          type: boolean
                                        color:
                                          type: string
                                      required:
                                        - value
                                        - prompt
                                        - included
                                        - color
                                required:
                                  - value
                                  - reason
                                  - cost
                                  - createdAt
                                  - updatedAt
                                  - id
                                  - name
                                  - description
                                  - default
                                  - type
                                  - options
                      required:
                        - id
                        - userID
                        - sessionID
                        - projectID
                        - environmentID
                        - createdAt
                        - updatedAt
                        - expiresAt
                        - endedAt
                        - recordingURL
                        - properties
                        - evaluations
                required:
                  - transcripts
      security:
        - auth: []
components:
  securitySchemes:
    auth:
      type: apiKey
      in: header
      name: authorization
      description: Voiceflow API key

````