---
title: "List available TTS voices"
method: POST
path: "/voice/voices"
tags: ["Media AI — Voice"]
---

# List available TTS voices

`POST /voice/voices`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/voice/voices`
- Auth: HTTP bearer

TTS voice catalog: POST /voice/voices. In TTS jobs language wins on mismatch, voice substituted (Abigail+language=de → Anneliese, warnings[]). Returns voices grouped by language with name, gender, tier, sample_url. Optional language...

## Response `200`

Success

- object: List available TTS voices
  - `_billing` object
    - `credits` object
      - `total_monthly` integer
      - `remaining_monthly` integer
      - `credit_source` string
      - `api_handler` string
      - `tier_info` object
        - `tier` string
        - `name` string
        - `initial_credits` integer
        - `price_monthly` integer
        - `price_overage_per_credit` integer
      - `notice` string
      - `renewal_days` integer
      - `subscription_status` string
    - `job` object
      - `api_job_name` string
      - `app` string
      - `action` string
      - `default_credits` integer
      - `credits_billed` integer
      - `pricing` object
        - `credits_per_unit` integer
        - `unit` string
        - `unit_count` integer
        - `addons` string
    - `requests` object
      - `limits` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `current` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `remaining` object
        - `second` integer
        - `minute` integer
        - `hour` integer
        - `day` integer
      - `next_possible_request_seconds` integer
    - `remaining_credits` integer
    - `total_monthly` integer
    - `account_id` integer
    - `plan` object
      - `tier` string
      - `name` string
    - `credits_billed` integer
  - `message` string
  - `processing_time` string
  - `status` string
  - `total_languages` integer
  - `total_voices` integer
  - `voices` object
    - `ar` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `cs` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `de` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `en` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `es-ES` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `es-MX` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `fr` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `hi` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `hu` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `it` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `ja` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `ko` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `nl` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `pl` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `pt-BR` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `pt-PT` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `ru` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `tr` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `zh-cn` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `bg` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `da` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `el` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `et` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `fi` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `he` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `hr` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `id` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `lt` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `lv` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `ms` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `no` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `ro` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `sk` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `sl` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `sr` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `sv` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `th` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `uk` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string
    - `vi` object[]
      - `name` string
      - `gender` string
      - `tier` string
      - `sample_url` string

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)
