---
title: "Get Timbre List"
method: GET
path: "/v2/voices"
tags: ["Voice"]
---

# Get Timbre List

`GET /v2/voices`

Retrieve a list of available timbres with filtering options.
Supports pagination and various filters including gender, language, age, and use case.

## Query parameters

- `page` integer
- `page_size` integer
- `gender` 'female' | 'male'
- `language` string
- `age` 'young' | 'middle_aged' | 'old'
- `use_case` string

## Response `200`

Success

- object
  - `code` integer, required — Business status code: * 0 - Success * 10104 - Record not found * 10105 - Invalid API key * 18020 - Insufficient credit * 18025 - No permission to call APIs * 40000 - Parameter error * 50000 - System error
  - `msg` string, required — Response message
  - `data` object
    - `voices` object[] — List of voices
      - `name` string — Voice name
      - `voice_id` string — Voice identifier
      - `audio_url` string, uri — Voice sample audio URL
      - `language` string — Voice language
      - `gender` 'female' | 'male' — Voice gender
      - `age` 'young' | 'middle_aged' | 'old' — Voice age group
      - `accent` string — Voice accent
      - `use_case` string — Recommended use case
    - `has_more` boolean — Whether there are more results

---

[API](https://skmtc.net/jogg/apis/joggai-openapi-v2.md) · [All operations](https://skmtc.net/jogg/apis/joggai-openapi-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jogg/joggai-openapi-v2/versions/ec8807ce9c12/schema)