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

# Get recording utterances

> Get utterances for a specific recording with pagination support



## OpenAPI

````yaml specs/openapi-internalApi.json get /v1/core/recordings/{id}/utterances
openapi: 3.0.0
info:
  version: 1.0.0
  title: Swagger API
servers:
  - url: https://api.siro.ai/
    description: Siro API Gateway
security: []
externalDocs:
  description: View the raw OpenAPI Specification in JSON format
  url: /swagger.json
paths:
  /v1/core/recordings/{id}/utterances:
    get:
      summary: Get recording utterances
      description: Get utterances for a specific recording with pagination support
      parameters:
        - schema:
            type: string
            description: Recording ID
          required: true
          description: Recording ID
          name: id
          in: path
        - schema:
            type: string
            description: Cursor for pagination (1-indexed page number)
          required: false
          description: Cursor for pagination (1-indexed page number)
          name: cursor
          in: query
        - schema:
            type: string
            description: 'Number of utterances to return per page (default: 100000)'
          required: false
          description: 'Number of utterances to return per page (default: 100000)'
          name: pageSize
          in: query
      responses:
        '200':
          description: Get recording utterances
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      utterances:
                        type: array
                        items:
                          type: object
                          properties:
                            utterance:
                              type: string
                              description: A piece of a redacted transcript.
                              example: hello
                            startTimeInMillis:
                              type: number
                              description: Start time of the utterance in milliseconds.
                              example: 39210
                            endTimeInMillis:
                              type: number
                              description: End time of the utterance in milliseconds.
                              example: 39610
                            speakerTag:
                              type: string
                              description: >-
                                Unique key identifying the speaker. Used as the
                                key to the speakerMap object.
                              example: '0'
                            redacted:
                              type: boolean
                              description: Whether this utterance has been redacted.
                              example: false
                            confidence:
                              type: number
                              description: >-
                                Double value from 0 to 1 identifying the
                                transcription confidence
                              example: 0.99853516
                          required:
                            - utterance
                            - startTimeInMillis
                            - endTimeInMillis
                            - speakerTag
                            - redacted
                      isLowDataMode:
                        type: boolean
                      speakerMap:
                        type: object
                        additionalProperties:
                          type: string
                        example:
                          '0': Rep Jim
                          '1': Customer Bob
                    required:
                      - utterances
                      - isLowDataMode
                      - speakerMap
                    additionalProperties: false
                  pageSize:
                    type: number
                    nullable: true
                  cursor:
                    type: number
                    nullable: true
                required:
                  - data
                  - pageSize
                  - cursor
        '400':
          description: Bad Request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                required:
                  - error
        '401':
          description: Unauthorized - User not authenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Authentication error message
                required:
                  - error
        '403':
          description: Forbidden - User does not have access
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Authorization error message
                required:
                  - error
        '404':
          description: Not Found - Resource not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Resource not found error message
                required:
                  - error
        '422':
          description: Unprocessable Content - The request failed validation checks
          content:
            application/json:
              schema:
                type: object
                properties:
                  issues:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: string
                        expected:
                          type: string
                        received:
                          type: string
                        path:
                          type: array
                          items:
                            anyOf:
                              - type: string
                              - type: number
                        message:
                          type: string
                      required:
                        - code
                        - path
                        - message
                  name:
                    type: string
                    enum:
                      - ZodError
                required:
                  - issues
                  - name
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Internal server error message
                required:
                  - error
      security:
        - SiroAuthToken: []
components:
  securitySchemes:
    SiroAuthToken:
      type: apiKey
      in: header
      name: x-siro-auth-token
      description: >-
        OAuth access token for user-scoped requests (Authorization Code or
        machine-to-machine). Send header `x-siro-auth-token:
        <oauth-access-token>`. Not an organization API key.
      x-default: <oauth-access-token>

````