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

# List Recordings for Customer Interaction

> Return metadata for the recordings associated with the given customer interaction, ordered chronologically. Transcript-only recordings are included with `recording_url` set to `null`. When present, `recording_url` is a stable, authenticated Alpharun API URL that redirects to the audio file.

<Note>
  Recordings are returned from earliest to latest. `duration` is measured in seconds, and `recording_url` is `null` for transcript-only recordings that do not have an audio file.
</Note>


## OpenAPI

````yaml GET /customer-interactions/{CUSTOMER_INTERACTION_ID}/recordings
openapi: 3.0.1
info:
  title: Alpharun API
  description: Alpharun REST API reference
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.alpharun.com/api/v1
security:
  - bearerAuth: []
paths:
  /customer-interactions/{CUSTOMER_INTERACTION_ID}/recordings:
    get:
      summary: List customer interaction recordings
      description: >-
        Return metadata for the recordings associated with the given customer
        interaction, ordered chronologically. Transcript-only recordings are
        included with `recording_url` set to `null`. When present,
        `recording_url` is a stable, authenticated Alpharun API URL that
        redirects to the audio file.
      parameters:
        - name: CUSTOMER_INTERACTION_ID
          in: path
          description: ID of the customer interaction to fetch recordings for
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Customer interaction recordings
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - customer_interaction
                    properties:
                      customer_interaction:
                        type: object
                        required:
                          - id
                          - recordings
                        properties:
                          id:
                            type: string
                            format: uuid
                            description: ID of the customer interaction
                          recordings:
                            type: array
                            description: >-
                              Recordings associated with the customer
                              interaction, ordered from earliest to latest
                            items:
                              type: object
                              required:
                                - id
                                - date
                                - duration
                                - recording_url
                              properties:
                                id:
                                  type: string
                                  format: uuid
                                  description: ID of the recording
                                date:
                                  type: string
                                  format: date-time
                                  description: >-
                                    UTC date and time when the recording was
                                    made
                                duration:
                                  type: number
                                  minimum: 0
                                  description: Duration of the recording in seconds
                                recording_url:
                                  type: string
                                  format: uri
                                  nullable: true
                                  description: >-
                                    Stable, authenticated API URL for the
                                    recording audio. `null` when the recording
                                    has a transcript but no audio file.
              example:
                data:
                  customer_interaction:
                    id: 11111111-2222-3333-4444-555555555555
                    recordings:
                      - id: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
                        date: '2026-01-02T10:00:00.000Z'
                        duration: 45
                        recording_url: >-
                          https://api.alpharun.com/api/v1/customer-interactions/11111111-2222-3333-4444-555555555555/recordings/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/audio
                      - id: ffffffff-1111-2222-3333-444444444444
                        date: '2026-01-03T10:00:00.000Z'
                        duration: 30
                        recording_url: null
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Customer interaction not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````