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

# Get User Timbre List

`GET /v2/voices/custom`

Retrieve a list of user's custom timbres with filtering options.
Returns user's personalized voice collection.

## Query parameters

- `language` 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
    - `total` integer — Total number of custom voices
    - `voices` object[] — List of custom voices
      - `name` string — Voice name
      - `voice_id` string — Voice identifier
      - `audio_url` string, uri — Voice sample audio URL
      - `language` string — Voice language

---

[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/revisions/ec8807ce9c12/schema)