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

# List audio

> Returns the audio you've created, newest first, one page at a time.

Each item has the fields described in [Audio fields](https://docs.olimi.ai/api-reference/endpoint/speech/text-to-speech.md#audio-fields). `attachment.url` is only present for audio that's `completed`, and expires after one hour.

Use `meta.totalPages` to know when you've fetched every page.


## OpenAPI

````yaml get /api/v2/tts
openapi: 3.0.1
info:
  title: Customer Management API
  description: API for managing customer lists and customers within those lists
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api-eg.olimi.ai
security:
  - bearerAuth: []
paths:
  /api/v2/tts:
    get:
      tags:
        - Text to Speech
      summary: List audio
      description: Returns the audio you've created, newest first, one page at a time.
      parameters:
        - name: page
          in: query
          required: false
          description: Page number, starting at `1`.
          schema:
            type: integer
            minimum: 1
            default: 1
        - name: limit
          in: query
          required: false
          description: Items per page.
          schema:
            type: integer
            minimum: 1
            default: 10
        - name: search
          in: query
          required: false
          description: >-
            Matches audio whose text, name, voice name or voice key contains
            this. Not case-sensitive.
          schema:
            type: string
        - name: voice
          in: query
          required: false
          description: >-
            Only audio spoken by this voice: its exact `name` or `voiceKey`. A
            voice `id` isn't accepted.
          schema:
            type: string
      responses:
        '200':
          description: A page of audio.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TtsListResponse'
        '401':
          description: The `X-API-KEY` header is missing or the key isn't valid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
      security:
        - apiKeyAuth: []
components:
  schemas:
    TtsListResponse:
      type: object
      properties:
        message:
          type: string
          example: Text-to-speech records fetched successfully
        meta:
          $ref: '#/components/schemas/PaginationMeta'
        data:
          type: array
          items:
            $ref: '#/components/schemas/TtsRecord'
    ApiError:
      type: object
      properties:
        statusCode:
          type: integer
          example: 404
        errorCode:
          type: string
          description: Machine-readable error code.
          example: agent_not_found
        message:
          type: string
          description: Human-readable text. May change; don't match on it.
          example: Agent not found
    PaginationMeta:
      type: object
      properties:
        totalItems:
          type: integer
          description: Total items across all pages.
          example: 12
        itemCount:
          type: integer
          description: Items on this page.
          example: 10
        itemsPerPage:
          type: integer
          description: The `limit` used.
          example: 10
        totalPages:
          type: integer
          description: Number of pages.
          example: 2
        currentPage:
          type: integer
          description: The `page` returned.
          example: 1
    TtsRecord:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: The audio's ID.
          example: 457ede41-97c7-44c6-bdd8-b9e4ca37f812
        name:
          type: string
          description: Your label, or `TTS_<timestamp>` if you didn't send one.
          example: greeting
        input:
          type: string
          description: The text that was spoken.
          example: أهلاً بيك، إزيك النهارده؟
        status:
          type: string
          enum:
            - pending
            - completed
            - failed
          description: >-
            See [Status
            values](/api-reference/endpoint/speech/text-to-speech#status-values).
          example: completed
        duration:
          type: integer
          description: >-
            Length of the audio in seconds, rounded down. `0` until the audio is
            ready.
          example: 2
        responseFormat:
          type: string
          description: 'Always `pcm`: the encoding inside the WAV file.'
          example: pcm
        languageId:
          type: string
          format: uuid
          example: 2cdab2de-310d-59a3-ad68-b85b4526e37b
        voiceId:
          type: string
          format: uuid
          example: 118d2470-de1d-5093-86b3-f2d8adec3183
        attachment:
          $ref: '#/components/schemas/TtsAttachment'
        language:
          type: object
          properties:
            code:
              type: string
              example: ar-EG
            name:
              type: string
              example: Arabic - Egyptian
        voice:
          type: object
          properties:
            id:
              type: string
              format: uuid
              example: 118d2470-de1d-5093-86b3-f2d8adec3183
            name:
              type: string
              example: Farida
            voiceKey:
              type: string
              example: Kore
        createdAt:
          type: string
          format: date-time
          example: '2026-09-29T09:05:44.045Z'
        updatedAt:
          type: string
          format: date-time
          example: '2026-09-29T09:05:47.310Z'
    TtsAttachment:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: d853213e-03da-49af-8d7b-81a818d1a296
        originalName:
          type: string
          description: 'The file name: your `name` plus `.wav`.'
          example: greeting.wav
        mimeType:
          type: string
          example: audio/wav
        fileSize:
          type: string
          description: Size in bytes, as a string. `0` until the audio is ready.
          example: '128684'
        url:
          type: string
          nullable: true
          description: >-
            A temporary download link. Only present once `status` is
            `completed`; expires after one hour.
          example: >-
            https://<storage-host>/tts/d853213e-03da-49af-8d7b-81a818d1a296?X-Amz-Expires=3600&X-Amz-Signature=…
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.