Skip to main content

PageResponse_VoiceDto_

A single page of results. nextCursor is an opaque token to pass back as ?cursor= to fetch the following page; null means there are no more results.

items object[]required
  • Array [
    • idstring

    Unique identifier for the voice.

    Example: 7Hb2Kp9QvL3mNx0R8tZ4
    createdAtdate-time

    Timestamp when the voice was created.

    Example: 2026-01-15T09:30:00Z
    updatedAtdate-time

    Timestamp when the voice was last updated.

    Example: 2026-01-15T09:30:00Z
    podcastIdstring

    Identifier of the podcast this voice belongs to.

    Example: 7Hb2Kp9QvL3mNx0R8tZ4
    titlestringnullable

    Display name of the voice.

    Example: Morning Host
    descriptionstringnullable

    Short description of the voice.

    Example: Warm, conversational host voice for morning episodes.
    statusstring

    Lifecycle status; a voice is 'ready' once it has audio samples

    Possible values: [pending, ready, archived, failed]

    Example: ready
    verificationStatusstring

    Whether the voice has been verified for use

    Possible values: [pending, verified, rejected]

    Example: verified
    info object

    Additional voice metadata, including language and uploaded samples.

    languagestringnullable

    Primary language of the voice as an ISO 639-1 code.

    Example: en
    files object[]

    The uploaded audio samples backing this voice.

  • Array [
    • filenamestringnullable

    Stored filename of the audio sample.

    Example: sample-001.mp3
    originalNamestringnullable

    Original filename of the sample as uploaded by the client.

    Example: morning-host-take-1.mp3
    sizeint64nullable

    Size of the audio sample in bytes.

    Example: 204800
  • ]
  • ]
    • nextCursorstringnullable
    PageResponse_VoiceDto_
    {
      "items": [
        {
          "id": "7Hb2Kp9QvL3mNx0R8tZ4",
          "createdAt": "2026-01-15T09:30:00Z",
          "updatedAt": "2026-01-15T09:30:00Z",
          "podcastId": "7Hb2Kp9QvL3mNx0R8tZ4",
          "title": "Morning Host",
          "description": "Warm, conversational host voice for morning episodes.",
          "status": "ready",
          "verificationStatus": "verified",
          "info": {
            "language": "en",
            "files": [
              {
                "filename": "sample-001.mp3",
                "originalName": "morning-host-take-1.mp3",
                "size": 204800
              }
            ]
          }
        }
      ],
      "nextCursor": "string"
    }