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

# List Voices

> Search the managed voice catalog (ElevenLabs premade voices).

Every filter is enforced server-side and echoed in ``filters_applied``. The opaque
``next_cursor`` is bound to these filters; changing them with a cursor is ``400
invalid_cursor``.



## OpenAPI

````yaml /openapi/moda-public-api.yaml get /voices
openapi: 3.1.0
info:
  title: Moda Public API
  description: >
    Programmatic access to Moda's canvas design platform. Create designs, export
    assets, manage brand kits, and run AI design tasks.


    ## Versioning


    Pin response shapes with a calendar-dated `Moda-Version` header (e.g.
    `2026-05-01`). **The pin is global** — it applies to every endpoint in the
    request, not just the one you adopted it for, so raising it to use a new
    endpoint also moves your other responses to that version's shapes.


    ### Migrating `2026-04-12` → `2026-05-01`


    - **Tasks** move from the flat `JobResponse` (`job_id`, `canvas_url`,
    `can_export`) to the canonical `Task` envelope. The export artifact is now
    under `result.export` as `{url, format, page_count}`; update any code that
    read the export URL from the old top-level fields.

    - **Multi-page PNG/JPEG exports are delivered as a single `.zip`** of
    per-page files (`page-1.png`, …), so `result.export.format` is `zip`. For
    one bundled document instead, request `format=pdf` or `pptx`; for a single
    image, pass `page_number`.
  version: 1.0.0
  x-moda-api-version: '2026-05-01'
servers:
  - url: https://api.moda.app/v1
    description: Production
security: []
tags:
  - name: canvases
    description: List, search, read, export, and share canvases
  - name: tasks
    description: Start and monitor AI design tasks
  - name: organizations
    description: List organizations and teams
  - name: credits
    description: Check credit balance and usage
  - name: brand-kits
    description: Manage brand kits
  - name: remix
    description: Duplicate and edit canvases
  - name: share-links
    description: Resolve share URLs to canvas identifiers
  - name: uploads
    description: Upload files for use as attachments
  - name: voices
    description: >-
      Managed voices: capabilities, the voice catalog, favorites and
      pronunciation dictionaries
  - name: usage
    description: Aggregate API usage stats for the caller's team
  - name: feedback
    description: Submit product feedback from Voyager
  - name: embed
    description: Signed iframe embed sessions
  - name: web
    description: 'Metered web research: search and page reading'
  - name: websites
    description: >-
      Create, update, publish, screenshot, and manage hosted multi-page static
      sites
  - name: drive
    description: >-
      Organize the workspace: folders, the folder tree, and item
      move/rename/visibility/delete for folders, canvases, and files
paths:
  /voices:
    get:
      tags:
        - voices
      summary: List Voices
      description: >-
        Search the managed voice catalog (ElevenLabs premade voices).


        Every filter is enforced server-side and echoed in ``filters_applied``.
        The opaque

        ``next_cursor`` is bound to these filters; changing them with a cursor
        is ``400

        invalid_cursor``.
      operationId: voicesList
      parameters:
        - name: query
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 200
              - type: 'null'
            title: Query
        - name: language
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 16
              - type: 'null'
            title: Language
        - name: accent
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 100
              - type: 'null'
            title: Accent
        - name: use_case
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 100
              - type: 'null'
            title: Use Case
        - name: gender
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 16
              - type: 'null'
            title: Gender
        - name: include_unavailable
          in: query
          required: false
          schema:
            type: boolean
            default: false
            title: Include Unavailable
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 1024
              - type: 'null'
            title: Cursor
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            default: 30
            title: Limit
        - $ref: '#/components/parameters/ModaVersion'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoicePage'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '402':
          description: Insufficient credits for a metered operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: Permission denied for this scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          description: Resource not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '409':
          description: Conflict (idempotency / resource state).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '422':
          description: Request validation failed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '429':
          description: Rate limit exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '500':
          description: Internal error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - API Key: []
components:
  parameters:
    ModaVersion:
      name: Moda-Version
      in: header
      required: false
      description: >-
        Calendar-dated API version pin. New integrations should pin `2026-05-01`
        to opt into the newest response shapes. For back-compat the server also
        accepts requests with no header and resolves them to the current default
        (today: `2026-04-12`); that default advances on each [sunset
        date](/api-reference/versioning). Any unsupported value returns 400
        `unsupported_version`.
      example: '2026-05-01'
      schema:
        type: string
        enum:
          - '2026-04-12'
          - '2026-05-01'
        default: '2026-05-01'
        example: '2026-05-01'
  schemas:
    VoicePage:
      properties:
        object:
          type: string
          const: list
          title: Object
          default: list
        data:
          items:
            $ref: '#/components/schemas/Voice'
          type: array
          title: Data
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
        returned:
          type: integer
          title: Returned
        has_more:
          type: boolean
          title: Has More
        limit:
          type: integer
          title: Limit
        total:
          type: integer
          title: Total
        filters_applied:
          $ref: '#/components/schemas/VoiceFiltersApplied'
      additionalProperties: false
      type: object
      required:
        - data
        - next_cursor
        - returned
        - has_more
        - limit
        - total
        - filters_applied
      title: VoicePage
    ErrorEnvelope:
      properties:
        type:
          $ref: '#/components/schemas/ErrorType'
        code:
          type: string
          title: Code
          description: >-
            Stable machine string keyed to doc_url. Never changes once
            published.
        message:
          type: string
          title: Message
          description: >-
            Human-readable message, for developers. Not localized, not
            user-facing.
        doc_url:
          type: string
          title: Doc Url
          description: Permalink to the docs page for this code.
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Request Id
          description: Correlator for logs/Sentry/audit.
        causes:
          anyOf:
            - items:
                $ref: '#/components/schemas/ErrorEnvelope'
              type: array
            - type: 'null'
          title: Causes
          description: Aggregated upstream failures (e.g. per-page export errors).
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Details
          description: >-
            Code-specific detail payload (e.g. validation field list). Callers
            should pass ``None`` rather than ``{}`` to omit the key from the
            response.
        retry_after_ms:
          anyOf:
            - type: integer
            - type: 'null'
          title: Retry After Ms
          description: Hint for rate-limited or transient errors.
        retryable:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Retryable
          description: >-
            Explicit retryability for this code, from the error-code registry:
            ``false`` means retrying the same request cannot succeed (fix the
            input / resource first); ``true`` means the condition is transient
            and a retry (with backoff / after the blocker clears) can succeed.
            Omitted for codes whose retryability is context-dependent — do not
            derive it from ``type`` or the HTTP status when this field is
            present.
      type: object
      required:
        - type
        - code
        - message
        - doc_url
      title: ErrorEnvelope
      description: >-
        Canonical error payload, nested under the top-level ``{"error": ...}``
        key.
    Voice:
      properties:
        object:
          type: string
          const: voice
          title: Object
          default: voice
        id:
          type: string
          title: Id
        name:
          type: string
          title: Name
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        category:
          type: string
          title: Category
        source:
          type: string
          title: Source
        labels:
          $ref: '#/components/schemas/VoiceLabels'
        languages:
          items:
            $ref: '#/components/schemas/VoiceLanguage'
          type: array
          title: Languages
        compatible_models:
          items:
            type: string
          type: array
          title: Compatible Models
        recommended_models:
          items:
            type: string
          type: array
          title: Recommended Models
        preview:
          anyOf:
            - $ref: '#/components/schemas/VoicePreview'
            - type: 'null'
        availability:
          $ref: '#/components/schemas/VoiceAvailability'
        catalog_refreshed_at:
          type: string
          title: Catalog Refreshed At
      additionalProperties: false
      type: object
      required:
        - id
        - name
        - description
        - category
        - source
        - labels
        - languages
        - compatible_models
        - recommended_models
        - preview
        - availability
        - catalog_refreshed_at
      title: Voice
      description: The list form of a voice (section 3.3).
    VoiceFiltersApplied:
      properties:
        query:
          anyOf:
            - type: string
            - type: 'null'
          title: Query
        language:
          anyOf:
            - type: string
            - type: 'null'
          title: Language
        accent:
          anyOf:
            - type: string
            - type: 'null'
          title: Accent
        use_case:
          anyOf:
            - type: string
            - type: 'null'
          title: Use Case
        gender:
          anyOf:
            - type: string
            - type: 'null'
          title: Gender
        include_unavailable:
          type: boolean
          title: Include Unavailable
      additionalProperties: false
      type: object
      required:
        - query
        - language
        - accent
        - use_case
        - gender
        - include_unavailable
      title: VoiceFiltersApplied
    ErrorType:
      type: string
      enum:
        - invalid_request
        - authentication
        - permission
        - not_found
        - conflict
        - rate_limited
        - idempotency_conflict
        - unprocessable
        - upstream_error
        - internal_error
      title: ErrorType
      description: Closed set of high-level categories SDKs branch on.
    VoiceLabels:
      properties:
        accent:
          anyOf:
            - type: string
            - type: 'null'
          title: Accent
        age:
          anyOf:
            - type: string
            - type: 'null'
          title: Age
        gender:
          anyOf:
            - type: string
            - type: 'null'
          title: Gender
        use_case:
          anyOf:
            - type: string
            - type: 'null'
          title: Use Case
        descriptive:
          anyOf:
            - type: string
            - type: 'null'
          title: Descriptive
      additionalProperties: false
      type: object
      required:
        - accent
        - age
        - gender
        - use_case
        - descriptive
      title: VoiceLabels
    VoiceLanguage:
      properties:
        language:
          type: string
          title: Language
        accent:
          anyOf:
            - type: string
            - type: 'null'
          title: Accent
        locale:
          anyOf:
            - type: string
            - type: 'null'
          title: Locale
      additionalProperties: false
      type: object
      required:
        - language
        - accent
        - locale
      title: VoiceLanguage
    VoicePreview:
      properties:
        url:
          type: string
          title: Url
        mime_type:
          type: string
          title: Mime Type
          default: audio/mpeg
        expires_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Expires At
      additionalProperties: false
      type: object
      required:
        - url
      title: VoicePreview
    VoiceAvailability:
      properties:
        status:
          type: string
          title: Status
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
        revoked_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Revoked At
      additionalProperties: false
      type: object
      required:
        - status
        - reason
        - revoked_at
      title: VoiceAvailability
  securitySchemes:
    API Key:
      type: http
      description: API key from Settings > Developer > REST API
      scheme: bearer

````