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
    created_atdate-time

    Timestamp when the voice was created.

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

    Timestamp when the voice was last updated.

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

    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
    verification_statusstring

    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
    original_namestringnullable

    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
  • ]
  • ]
  • next_cursorstringnullable
    PageResponse_VoiceDto_
    {
    "items": [
    {
    "id": "7Hb2Kp9QvL3mNx0R8tZ4",
    "created_at": "2026-01-15T09:30:00Z",
    "updated_at": "2026-01-15T09:30:00Z",
    "podcast_id": "7Hb2Kp9QvL3mNx0R8tZ4",
    "title": "Morning Host",
    "description": "Warm, conversational host voice for morning episodes.",
    "status": "ready",
    "verification_status": "verified",
    "info": {
    "language": "en",
    "files": [
    {
    "filename": "sample-001.mp3",
    "original_name": "morning-host-take-1.mp3",
    "size": 204800
    }
    ]
    }
    }
    ],
    "next_cursor": "string"
    }